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1.  INTRODUCTION 

This  training  manual  presupposes  virtually  no  programming  experience  and  is 
intended  to  provide  step  by  step  information  necessary  to  begin  using  AISIM 
version  5.0  as  hosted  on  a  VAX  11/780.  It  is  not  intended  as  a  complete 
account  of  the  system,  and  many  topics  covered  in  the  companion  AISIM  User's 
Manual  are  covered  here  in  less  detail,  or  not  at  all.  For  further  details  on 
the  operation  of  AISIM  or  on  the  kind  of  simulation  AISIM  is  adapted  to,  the 
reader  is  referred  to  the  more  detailed  AISIM  User's  Manual. 

This  manual  consists  of  seven  sections.  This  first  section  provides  a  brief 
overview  of  AISIM  and  its  main  concepts.  Sections  2,  3  and  4  concern  the 
Design  User  Interface  (DUI),  i.e.,  that  part  of  AISIM  in  which  models  are 
created.  Section  5  describes  the  complete  construction  of  a  simple  model. 
Section  6  turns  to  the  use  of  the  Analysis  User  Interface — the  part  of  AISIM 
where  simulation  and  analysis  occur — using  the  model  developed  in  Section  5  as 
an  example.  Finally,  Section  7  will  document  the  creation,  simulation  and 
analysis  of  a  more  complex  system. 

1 . 1  MODELING 


A  computer  model  is  a  description  of  a  system  that  is  developed  as  a  basis  for 
calculations,  predictions  or  further  investigation.  AISIM  is  especially 
designed  to  model  systems  that  Incorporate  parallel  processing.  The  purpose  of 
an  AISIM  model  is  to  give  information  on  the  workability  of  a  system  design, 
especially  by  providing  statistics  that  serve  to  predict  the  operation  of  the 
modeled  system  if  Implemented. 

Modeling  is  accomplished  in  AISIM  by  representing  the  elements  of  the  system 
being  modeled  in  terms  of  AISIM  "entities."  A  detailed  description  of  each 
entity  is  provided  in  Section  3  of  the  AISIM  User's  Manual.  A  general 
introduction  to  the  types  of  system  elements  modeled  by  these  AISIM  entities 
is  contained  in  section  1.3  of  this  manual. 

1.2  OVERVIEW  OF  THE  AISIM  SYSTEM 


AISIM  consists  of  seven  subsystems,  each  of  which  performs  a  distinct 
function.  These  subsystems  are:  (1)  the  Design  User  Interface  (DUI);  (2)  the 
Analysis  User  Interface  (AUI);  (3)  the  Replot  User  Interface  (RUI);  (4)  the 
Hardcopy  User  Interface  (HUI);  (5)  the  Library  User  Interface  (LUI);  (6)  the 
File  Management  User  Interface  (FUI);  and  (7)  the  Help  Editor  Interface  (HEI). 
Figure  1  shows  each  of  these  subsystems  and  the  major  components  of  each 
subsystem.  The  numbers  above  the  boxes  correspond  to  the  numbering  of  the 
subsystems  given  in  this  paragraph.  The  words  annotating  each  arrow  are  the 
commands  used  to  Invoke  each  subsystem  or  component,  and  the  symbols  in  the 
boxes  are  the  prompts  seen  after  each  subsystem  or  component  has  been  invoked. 
Following  figure  1  is  a  brief  description  of  each  of  these  subsystems. 


I 


COW30  COW  40 


(1)  DESIGN  USER  INTERFACE 


The  DUI  is  the  facility  which  enables  the  user  to  create  or  alter  models  of 
systems.  It  contains  two  sublevels,  the  Architecture  Design  Editor  (ADE)  and 
the  Process  Editor  Interface  (PEI).  The  ADE  is  used  to  model  the  physical 
layout  of  the  given  system,  which  is  called  the  architecture.  The  PEI  is  used 
to  define  the  processes  or  logic  that  are  associated  with  that  architecture. 
Other  model  entities  are  defined  at  the  DUI  level. 

(2)  ANALYSIS  USER  INTERFACE 

With  the  AUI  one  subjects  the  model  defined  in  the  DUI  function  to  simulation 
runs  that  test  the  behavior  and  response  of  the  modeled  system  to  various 
hypothetical  conditions.  In  this  function  statistics  are  gathered  on  the 
operation  of  the  system  during  simulation  and,  if  desired,  graphs  of  selected 
parameters  are  generated  and  are  available  for  plotting. 

(3)  REPLOT  USER  INTERFACE 

The  REPLOT  function  enables  the  user  to  plot  the  statistics  from  various 
executions  of  a  model,  and  to  combine  these  plots  as  desired  for  future 
reference. 


(4)  HCOPY  USER  INTERFACE 

The  Hardcopy  function  provides  the  connection  between  the  AISIM  system  and  a 
printing  device  for  automatically  producing  hardcopies  of  model  logic. 
Process  flowcharts  constructed  in  the  DUI  can  be  printed  on  an  HP2631G 
printer /plotter,  a  TEK  4695  graphics  copier,  or  the  internal  printer  on  the 
HP2623  terminal. 

(5)  LIBRARY  USER  INTERFACE 


In  the  LUI  the  user  is  able  to  break  apart  and  recombine  parts  of  AISIM 
models,  and  obtain  parts  of  models  from  a  central  system  library.  This 
feature  is  provided  because  some  model  components  are  used  in  other  models  and 
it  is  sometimes  useful  to  store  entire  models  for  later  reuse. 


(6)  FILE  MANAGEMENT  USER  INTERFACE 


The  FUI  function  enables  the  user  to  create  and  manipulate  external  data  files 
to  be  used  by  the  READ  Primitive,  within  an  AISIM  Process. 


(7)  HELP  EDITOR  INTERFACE 


The  HEI  function  provides  a  means  for  users  to  access  and  create  help 
information. 


1.3  OVERVIEW  OF  AISIM  MODELING  CONSTRUCTS 


This  section  provides  a  brief  description  of  AISIM  modeling  constructs,  to  be 
followed  by  a  more  precise  description  of  them  in  subsequent  sections. 

With  some  qualifications,  AISIM' s  modeling  constructs  can  be  divided  into  the 
following  four  categories:  (l)  those  used  to  represent  the  operations,  proper¬ 
ties,  structure  and  internal  relations  of  the  modeled  system  itself;  (2)  those 
used  to  represent  the  environmental  stimuli  to  which  the  system  model  is 
exposed;  (3)  those  which  represent  the  physical  layout  of  the  system;  and  (A) 
those  which  represent  and  facilitate  mathematical  operations. 

1.3.1  ENTITIES  REPRESENTING  ELEMENTS  EXTERNAL  TO  THE  MODELED  SYSTEM 


1.3. 1.1  The  Load  Entity.  The  Load  entity  is  used  to  represent  aspects  of  the 
modeled  system  that  trigger  processes  within  it.  The  Load  entity  represents 
the  normal  demand  which  is  placed  on  the  modeled  system.  Loads  are  defined  by 
specifying  the  nodes  at  which  certain  Processes  are  to  take  place  within  a 
given  period  (see  Scenario),  together  with  specifications  of  several  param¬ 
eters  which  indicate  the  schedule  that  the  Process  triggering  follows.  The 
definition  of  a  Load  will  also  assign  a  priority  to  each  of  the  Processes 
being  triggered. 

1.3. 1.2  The  Scenario  Entity.  A  Scenario  is  used  to  represent  the  external 
demand  t>n  a  system  (i.e.,  Process  triggerings  from  the  outside)  throughout  a 
simulation  exercise.  The  Scenario  divides  a  simulation  run  into  a  number  of 
periods  that  determine  the  frequency  with  which  Loads  will  be  initiated.  They 
will  also  trigger  Processes  in  a  way  that  is  not  systematically  related  to  the 
Loads  in  order  to  represent  abnormal  impositions  on  the  system. 

1.3.2  ENTITIES  REPRESENTING  ELEMENTS  INTERNAL  TO  THE  MODELED  SYSTEM 


1.3. 2.1  The  Process  Entity.  A  Process  is  used  to  represent  the  operations, 
decisions,  actions  or  activities  that  can  be  decomposed  and  defined  in  terms 
of  more  fundamental  AISIM  entities,  called  Primitives.  A  Process  can  take 
place  in  one  or  more  of  the  system's  nodes  (or  may  execute  independent  of  the 
nodes)  and  can  make  use  of  one  or  more  Resources. 

1.3. 2. 1.1  The  Process  Primitives.  Primitives,  of  which  there  are  28,  are  the 
elements  of  which  Processes  are  composed.  A  Process  may  be  considered  to  be  a 
collection  of  Primitives  whose  sequential  execution  describes  the  logic  of  the 
Process. 

The  28  Primitives  can  be  arranged  into  eleven  categories  according  to  simi¬ 
larity  of  function.  For  the  present,  rather  than  give  the  meaning  of  each 
Primitive  individually,  it  is  sufficient  to  describe  the  categories  and  in  a 
general  way  characterize  the  roles  that  members  of  each  will  play  in  the 
definition  of  a  Process. 
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1.  INTERNAL  PROCESS  EXECUTION  CONTROL.  The  Primitives 

COMPARE 

BRANCH 

ENTRY 

PROB 

LOOP 

serve  as  a  “framework"  for  Processes,  enabling  the  Process  to  branch  (either 
unconditionally  or  under  certain  conditions)  to  another  portion  of  the 
Process,  or  to  repeat  certain  segments  of  the  Process  a  specified  number  of 
times. 

2.  RESOURCE  ALLOCATION .  As  mentioned  earlier,  a  Process  frequently 
competes  with  other  Processes  for  Resources.  The  Primitives 

ALLOC 

DEALLOC 

RESET 

TEST 

LOCK 

UNLOCK 

govern  the  allocation  of  Resources  among  the  various  competing  Processes. 

3.  PROCESS  EXECUTION  CONTROL.  Since  a  principal  feature  of  AISIM  is  its 
capacity  to  model  parallel  Processing,  i.e.,  distinct  Processes  executing  at 
the  same  time,  these  Primitives  govern  the  timing  of  various  Processes  in  the 
system  relative  to  one  another.  The  Primitives 

CALL 

SEND 

SUSPEND 

RESUME 

WAIT 

will  either  interrupt  the  Process  in  which  they  stand,  or  trigger  or 
re-initiate  some  other  Process. 

4.  QUEUE  HANDLING.  The  Primitives 

FILE 

FIND 

REMOVE 

govern  the  placement  and  retrieval  of  Items  in  Queues  that  have  been  defined 
by  the  user. 

5.  ITEM  HANDLING.  The  Primitives 

CREATE 

DESTROY 

govern  the  introduction  and  elimination  of  a  system's  transient  data  elements. 


6.  VARIABLE  MANIPULATION.  The  Primitive 


ASSIGN 

governs  the  assignment  of  values  to  variables  or  attributes  (both  numerical 
and  non-numerlcal ) . 

7.  MATHEMATICAL  OPERATIONS.  The  Primitive 

EVAL 

governs  calculations,  invoking  standard  mathematical  functions  and  operations 
or  making  use  of  user-defined  Tables. 

8.  TIME  SEQUENCING.  The  Primitive 

ACTION 

which  is  associated  with  the  Action  entity  described  below,  is  included  in 
Process  definitions  to  Indicate  the  time  a  certain  Action  (or  process, 
decision,  etc.)  takes  up  without  further  describing  the  Action's  nature. 

9.  DEBUGGING.  The  Primitive 

TRACE 

is  not  used  to  represent  a  system's  operations,  but  is  rather  provided  as  a 
debugging  facility  to  aid  the  user  in  the  task  of  tracing  a  history  of  Process 
execution  during  simulations. 

10.  INPUT /OUTPUT .  The  Primitives 

READ 

WRITE 

allow  the  input  and  output  of  AISIM  variables  (both  numerical  and 
non-nuroer 1  cal )  from  and  to  external  files. 

1 1 .  DOCUMENTATION.  The  Primitive 

COMMENT 


allows  documentation  to  be  entered  into  the  AISIM  model. 


1.3. 2. 2  The  Resource  Entity.  A  Resource  entity  represents  a  component  of  the 
modeled  system  which  may  be  necessary  for  the  execution  of  a  Process. 
Typically,  a  Resource  will  be  required  for  more  than  one  Process.  Where 
several  Processes  demand  a  Resource  that  can  serve  only  one  Process  at  a  time, 
all  but  one  will  stand  in  a  queue  until  the  Resource  is  available  for  them. 

The  order  in  which  the  Processes  will  make  use  of  the  contended  Resource  is  a 
function  of  the  priorities  associated  with  the  various  requests  for  the 
Resource . 


1.3. 2. 3  The  Action  Entity.  The  Action  entity  Is  used  in  conjunction  with  the 
ACTION  Primitive  to  represent  any  action,  activity,  decision,  etc.  that 
consumes  time.  The  entity  is  automatically  created  by  the  system  when  an 
ACTION  Primitive  is  placed. 

1.3. 2. U  The  Legal  Path  Table.  The  Legal  Path  Table  (LPT)  is  a  set  of  routes 
or  paths  between  nodes  in  the  system's  architecture.  The  LPT  is  selected  from 
all  the  possible  paths  between  the  nodes  along  the  links,  so  that  there  is  but 
one  permissible  routing  of  communication  between  the  various  nodes  in  the 
architecture.  The  LPT  is  accessed  by  several  other  elements  of  AISIM  such  as 
the  EVAL  Primitive,  the  keywords  5N0DE,  $NXTNODE,  and  SLINK,  and  the  Message 
Routing  Submodel  Processes. 

1.3. 2. 3  The  Queue  Entity.  A  Queue  represents  any  holding  area,  such  as  a 
memory  buffer  or  job  queue,  for  elements  waiting  to  take  up  their  role  in  the 
operation  of  the  system.  User-defined  Queues  can  be  used  as  a  holding  area 
for  Items.  A  user-defined  Queue  can  be  manipulated  in  a  number  of  ways 
described  later  and  in  the  AISIM  User's  Manual  section  3.4. 

1.3. 2. 6  The  File  Entity.  The  File  entity  is  used  to  associate  an  external 
file  with  a  model.  This  entity  is  used  in  conjunction  with  the  READ  and  WRITE 
Primitives.  The  AISIM  user  does  not  have  control  over  the  creation  and 
deletion  of  a  file  entity.  It  is  automatically  created  when  the  first  READ  or 
WRITE  Primitive  accessing  the  file  is  placed  and  automatically  deleted  when 
the  last  READ  or  WRITE  Primitive  accessing  the  file  is  deleted. 

Each  File  entity  contains  the  logical  name  of  a  file  to  be  accessed  during  the 
simulation.  Associated  with  each  logical  file  name,  there  must  be  an  actual, 
physical  file  to  which  data  is  written  or  from  which  data  is  read.  AISIM 
maintains  a  file  called  project. FNM  that  contains  a  list  of  all  logical  file 
names  in  a  model  and  the  physical  files  associated  with  each  of  those  logical 
file  names.  During  a  Design  session,  AISIM  reads  in  the  information  in  the 
”.FNM"  file  for  a  model,  makes  updates  as  necessary  as  the  user  updates  the 
model,  and  then  rewrites  the  file  at  the  end  of  the  Design  session. 

1.3.3  ENTITIES  WHICH  SUPPORT  MATHEMATICAL  OPERATIONS 

1.3. 3. 1  The  Constant  Entity.  A  Constant  is  an  entity  whose  value  does  not 
change  during  a  simulation  run.  Constants  are  specified  or  altered  in  the  DUI 
and  can  be  edited  before  a  simulation  run  in  the  AUI  but  cannot  be  changed 
(and  do  not  change)  once  the  execution  of  a  model  has  begun.  Several  param¬ 
eters  required  in  the  definition  of  an  AISIM  model,  (e.g.,  the  number  of 
Resource  units  available,  the  period  length  of  the  simulation  and  the  size  for 
Queues)  can  only  take  Constants  or  simple  numerics  as  values. 

1.3. 3. 2  The  Variable  Entity.  Variables,  by  contrast,  are  entities  whose 
values  can  change  during  the  exercise  of  a  model.  The  majority  of  the 
parameters  in  the  specification  of  a  model  can  take  Variables  as  values. 

1.3. 3. 3  The  Table  Entity.  Tables  are  single-value,  single-argument  functions 
defined  by  the  user.  They  may  be  defined  either  as  discrete,  continuous,  or 
alphanumeric  and  may  have  from  1  to  15  entries.  Tables  are  accessed  by  the 
EVAL  Primitive  and  serve  as  a  supplement  to  the  mathematical  operations 
automatically  available  as  part  of  the  EVAL  Primitive. 


1.4  OVERVIEW  OF  THE  AISIM  HELP  FACILITY 


The  HELP  Facility  provides  a  means  for  the  AISIM  user  to  receive  and  dissemi¬ 
nate  information  pertinent  to  the  AISIM  system.  It  allows  users  to  display 
information  on  AISIM  functions  and  modeling  concepts  or  it  allows  them  to 
enter  and  display  user  supplied  messages. 

1.4.1  DISPLAYING  HELP.  Entering  the  command  HELP  from  any  AISIM  function 
command  level  will  enable  the  user  to  request  that  help  Information  be 
displayed.  Users  can  either  be  guided  through  to  the  needed  information  by  a 
series  of  prompts,  or  they  car.  directly  access  the  information  by  specifying 
the  specific  topic.  The  format  of  the  display  screen  is  consistent  and  shows 
the  information  in  single  screen  pages.  When  a  specific  topic  has  more  than 
one  screen  of  information  the  user  is  prompted  with  the  following  message  to 
continue  viewing  the  subsequent  screens: 

PRESS  RETURN  TO  CONTINUE 

Upon  completing  the  last  screen  of  information  the  user  sees: 

NO  FURTHER  INFORMATION,  PRESS  RETURN  TO  CONTINUE  HELP 

Prior  to  terminating  the  initial  request  the  user  is  given  instructions  on  the 
additional  help  available. 

1.4.2  CREATING  HELP.  The  Help  Editor  Interface  (HEI)  UPDATE  command  is  used 
to  invoke  the  Update  Function.  This  interface  is  used  to  create  and  edit  user 
provided  help  information.  There  are  three  categories  for  the  user  informa¬ 
tion  to  be  contained  under:  notes,  guidelines,  and  procedures.  The  valid 
Update  commands  are:  Add,  Change,  Delete,  Help,  List,  Save,  and  End.  Only 
one  user  at  a  time  is  allowed  to  use  the  Update  Function  in  order  to  prevent 
multiple  users  from  changing  the  help  database  simultaneously. 


a 


2.  CREATING  SYSTEM  ARCHITECTURES 


With  the  basic  understanding  of  AISIM  modeling  concepts  presented  in  the 
previous  section,  the  reader  should  now  be  able  to  interact  with  the  DUI.  The 
exercises  here  are  intended  both  to  deepen  the  user's  grasp  of  AISIM  modeling 
constructs  and  to  familiarize  him  with  the  prompts  encountered  while  inter¬ 
acting  with  the  DUI.  In  general,  it  is  not  a  good  idea  to  begin  the  design  of 
an  AISIM  model  without  having  done  research  and  preparation  on  paper  before¬ 
hand.  However,  as  a  teaching  device,  we  shall  develop  fragments  of  an 
architecture  from  requirements  formulated  as  we  go  along. 

The  method  of  logging  on  and  invoking  AISIM  is  computer-specific  so  we  shall 
assume  that  the  user  has  reached  the  point  at  which  the  computer  prompts  him 
with 

AISIM  READY 

The  user  will  have  been  offered  a  collection  of  information  that  looks 
something  like  that  depicted  in  figure  2. 


This  is  AISIM  Production  Version  5.0V 
5/15/87 

***Please  report  any  problems  to:  The  MITRE  Corporation  D-76,  (617)  271-2274 


Figure  2.  Typical  Display  Upon  Entering  the  AISIM  READY  Level. 

To  enter  the  DUI,  type 

design  project(test)  terra(trratyp) 

"test”  is  the  name  of  the  model  to  be  designed.  Trmtyp  represents  the  type  of 
terminal  being  used. 

The  valid  terminal  types  are  the  following: 

HP  -  HP2647A,  HP2648A 
HP23  -  HP2623 

VT  -  VT100  with  Selanar  graphics 
TEK  -  Tektronix  4105 

The  user  will  be  prompted  with  information  that  looks  something  like  that 
shown  in  figure  3. 


AISIM  READY 

design  project (test )  term(hp) 

CURRENT  PARAMETERS  IN  EFFECT: 

VERSION:  PRODUCTION  VERSION  5.0 

TERMINAL:  HP 

PROJECT:  TEST 

USER:  [USER] 

ENTER  YES  TO  PROCEED,  NO  TO  ABORT... 

Figure  3.  Typical  Information  on  Entering  the  DUI 


By  typing 
NO 

the  user  will  return  to  the  AISIM  READY  level.  Typing 
YES 

will  put  the  user  in  the  DUI  and  the  screen  will  display  an  asterisk  to 
indicate  that  the  user  may  enter  DUI  commands. 

Obtain  help  Information  on  the  DUI  by  typing 

HELP 

The  following  information  will  appear  on  the  screen  as  shown  in  figure  4 
the  user  enters  a  carriage  return  in  response  to  the  prompt  to  continue. 


FUNCTION  LEUEL,DUI 


DESIGN  USER  INTERFACE  (DUI I 


The  DUI  *nd  it*  lower  levels  ere  used  to  define  •  model  by  creeling, 
modifying,  or  deleting  AISIM  model  entities.  The  Action,  Constenl,  Pern, 
toed.  Process,  Queue,  Resource,  Scenerio,  Table,  end  Variable  entities  are 
created  and  edited  at  the  DUI  level,  using  the  EDIT  command.  The  descriptions 
of  File  entities  can  be  modified  using  the  EDIT  command.  The  Process  entities 
which  represent  operations  in  the  modeled  system  are  created  and  edited  at  s 
sublevel  of  the  DUI  level  called  the  Process  Editor  Interface  tPEll.  The  PEI 
is  invoked  by  issuing  the  EDIT  command  tat  the  DUI  level!  and  specifying  a 
Process  as  the  entity  to  be  edited.  A  system  archi tec ture  and  its  related 
Legal  Path  Table,  nodes,  and  linl.s  are  defined  in  a  second  sublevel  of  the  DUI 
called  the  Architecture  Design  Editor  (mDE)  .  The  ADE  is  invoked  by  issuing 
the  ARCH  command  at  the  DU I  level . 


AISIM  has  a  restricted  character  set  for  all  data  entered  into  a  model.  Only 
the  characters  A-2,  0-9,  tdollar  sign  and  (underscore)  may  be  used 

for  model  entity  names  and  parameters .  Any  time  the  user  places  an  invalid 
character  in  a  name  or  a  form  field,  the  user  will  be  requested  to  correct  the 


PRESS  RETURN  TO  CONTINUE 


Figure  4.  DUI  Help 
10 


FUNCTION  LEUEL.DU! 


invalid  character.  Any  printable  Chirac  tan*  arc  allowed  in  "comment"  and 
"d**cr ipt ton"  fields  of  ferns  and  m  user-added  help  text  (see  saction  tl.2i. 

Whan  cm  ting  and  aditing  entities  in  the  DUI  laval  .  Uia  system  prompts 
tha  usar  for  furthar  information  Py  us*  of  forms.  Each  form  spacifias  tha 
required  and  optional  attributes  of  its  raspactiva  antity-typa.  Tha  areas 
on  winch  information  is  to  Pa  antarad  appaar  in  “ravarsa  vidao"  (dark 
Chirac  tars  on  a  light  background),  and  indicata  th*  attributes  that  ara  to 
be  supplied  by  tha  usar. 

Each  tima  th*  usar  prassas  th*  kayboard  carriag*  raturn  key,  the  character 
cursor  is  positioned  to  th*  start  of  another  designated  area.  Tha  usar 
enters  parameters  requested  Py  th*  form  by  keying  in  th*  desired 
alphanumeric  information.  If  th*  usar  changes  his  mind  about  tha 
parameters  previously  keyed  in,  he  may  alter  them  by  merely  writing  over 
th*  old  information.  Whan  the  usar  is  satisfied  with  th*  contents  of  th* 
form,  ha  inputs  i t  to  tha  computer  by  exiting  tha  form.  Below  is  a 
complete  description  of  the  usa  of  forms. 

While  th*  user  is  in  th*  DUI ,  all  changes  ara  mad*  to  a  working  copy  of 
PRESS  RETURN  TO  CONTINUE 


Figure  4.  DUI  Help  (continued) 


FUNCTION  LEUEL.DUl 


tit*  user's  database.  Khan  th*  usar  issues  a  SAOE  command  during  or  at  Hie 
and  of  tha  DUI  session,  tha  working  database  is  copied  back  into  tha 
user's  real  database.  This  procedure  enables  tha  usar  to  change  his/her 
mind  about  changes  made  in  lit*  working  database  and  to  protect  the  user's 
real  database  in  case  the  computer  crashes  during  a  DUI  session. 

AUA I L ABLE  SUBTOPICS  ARE : 

ARCH  COPY  DELETE  EDIT 

END  HELP  LIST  SAUE 

UNITS 

SUBTOPIC  NAHE-> 


Figure  4.  DIJI  Help  (continued) 


Entering  ARCH  In  response  to  the  Subtopic  Name  prompt  will  display  the 
information  in  figure  5. 


FUNCTION  LEUEL,OU!,ARCH 


Th*  ARCH  coMind  is  used  »o  invoke  lh*  Architecture  0**130  Editor  1AOE1  . 
This  cowand  1*  valid  only  in  th*  CMJI  Ready  Level. 

COMMAND  SYNTAX! 

ARCH 

A 

FUNCTION  RESULT: 

Th*  AOE  i*  invoked  so  that  th*  architecture  is  built  under  th*  project 
designated  by  th*  DESIGN  conn  and.  A  •  prexyat  is  provided  for  th*  user  to 
input  AOE  contends .  These  com  and*  are  discussed  in  section  6.3. 

NO  FURTHER  INFORMATION,  PRESS  RETURN  TO  CONTINUE  HELP 


Figure  5.  ARCH  Help 


By  entering  the  carriage  return  mentioned  in  figure  5  a  screen  will  be 
displayed  providing  an  opportunity  to  request  additional  help.  Entering  a 
carriage  return  will  return  the  user  to  the  DUI. 

When  the  computer  redisplays  the  prompt  enter  the  Architecture  Design 

Editor  (ADE)  by  typing 

ARCH 

A  grid  like  that  in  figure  6  will  appear  on  the  screen. 


The  AISIM  constructs  Manipulated  In  the  ADE  are  nodes  which  represent  the 
hardware  elements  of  a  system  and  links  which  represent  lines  of  communication 
between  them.  The  physical  layout  of  the  system  Is  represented  by  placing 
nodes  and  links  on  the  grid  to  represent  various  hardware  elements  of  a  system 
and  their  (available)  lines  of  communication.  A  Resource  modeling  entity  Is 
automatically  created  for  each  node  or  link  when  It  Is  placed  In  the 
architecture. 

As  a  mnemonic  aid  In  distinguishing  system  elements,  AISIM  provides  fourteen 
geometrical  symbols  for  nodes.  The  symbols  are  called  by  the  three-letter 
designations  given  In  figure  7. 


Figure  7.  Designation*  of  the  Fourteen  Symbols 


With  two  exceptions  these  node  symbols  differ  from  one  another  only  in  their 
appearance.  The  two  exceptions  are  the  so-called  "leaf-nodes'*  TTY  and  LOD. 
These  nodes  may  be  connected  to  the  modeled  architecture  by  only  one  link. 

All  other  nodes  may  be  connected  to  any  number  of  other  nodes  through  any 
number  of  links.  The  rationale  for  this  restriction  is  explained  in  the  AISIM 
User's  Manual,  section  6.3.3. 

2.1  DRAW  AND  NODRAW  MODES 

In  the  ADE  there  are  two  modes  called  DRAW  mode  and  NODRAW  mode.  When  the 
user  is  in  DRAW  mode,  all  architecture  commands  which  change  something  in  the 
architecture  display  cause  the  display  to  be  updated  immediately.  If  the  user 
la  in  NODRAW  mode,  the  architecture  display  is  not  automatically  updated.  The 
user  can  cause  the  display  to  be  updated  by  typing 

REDRAW 


DRAW  mode  is  the  default  on  HP  terminals  and  TEK4105  terminals.  NODRAW  mode 
is  the  only  mode  available  on  VT100  terminals.  This  restriction  is  due  to  a 
lack  of  capability  in  the  terminal  to  make  It  operate  like  the  other  termi¬ 
nals.  Therefore,  if  a  user  is  on  a  VT100,  he  must  type  REDRAW  to  see  the 
results  of  any  ADE  commands.  The  following  discussions  assume  the  user  is  on 
a  terminal  other  than  a  VTIOO  except  where  specifically  noted.  If  the  user  is 
on  a  VTIOO  terminal,  he  will  need  to  use  the  REDRAW  command  to  view  the 
results  of  the  ADE  commands  described  in  the  following  sections. 


hnMuvukia 


2.2  DEFINING  ATTRIBUTES  FOR  SYMBOLS 


As  mentioned  earlier,  when  a  symbol  is  placed  in  the  architecture,  an  AISIM 
entity  called  a  Resource  is  created  to  represent  the  hardware  element  depicted 
by  the  node  or  link.  Resources  can  have  a  number  of  user-named  attributes. 

The  DEFINE  SYMBOL  command  allows  the  user  to  associate  attributes  with  each 
symbol  type  so  that  when  placed  in  the  architecture,  the  Resource  will  be 
created  with  all  attributes  defined.  For  example,  after  typing: 

DEFINE  SQR 

(SQR  could  be  replaced  with  any  of  the  14  symbol  mnemonics  or  the  mnemonic  CON 
if  a  link  is  being  defined.)  The  user  will  be  prompted  by  a  form  as  shown  in 
figure  8. 


PE  SOURCE  NAME  : 

TGThL  NUMBER  OF  UNITS : 

INITIAL  NUMBER  OF  UNITS: 

DESCRIPTION:  ■■■■■■■■■■■■ 

ATTRIBUTES 

NAME  ualue  name  UALUE 


Figure  8.  Symbol  Definition  Form 


The  user  can  add  or  modify  fields  within  this  form  by  using  the  terminal  keys 
as  defined  in  appendix  A.  Any  values  in  the  inverse  video  fields  of  the  form 
are  default  values  supplied  from  the  AISIM  design  data  base.  The  user  may 
change  these  fields  by  typing  over  the  existing  values.  The  user  may  enter  up 
to  fifteen  attribute  names  and  related  values  of  his  choice  into  the  attribute 
fields.  For  example,  when  defining  attributes  of  a  symbol  type  which  is  to 
represent  a  disk  in  the  modeled  system,  the  attribute  names  may  be  something 
like  seek  time,  latency,  etc.,  and  the  values  would  be  the  corresponding 
values  for  the  particular  disk  being  modeled. 


A  second  use  of  the  DEFINE  SYMBOL  command  is  the  following: 


DEFINE  SYMBOL, RESOURCE  NAME 

where  SYMBOL  is  one  of  the  symbol  mnemonics  or  CON,  and  RESOURCE  NAME  is  the 
name  of  an  existing  Resource  entity.  If  the  named  Resource  entity  exists,  a 
form  similar  to  the  form  shown  above  would  be  displayed.  Instead  of  the 
default  attributes,  the  form  displayed  would  have  the  names  and  values  of  any 
attributes  previously  defined  for  the  Resource  entity  referenced  in  the 
command. 

This  command  will  only  be  accepted  if  a  Resource  entity  has  been  previously 
defined  before  entering  the  ADE.  Since  the  user  has  not  defined  any  Resource 
entities  in  his  test  data  base  yet,  this  command  would  fail.  The  user  might 
want  to  try  this  command  later. 

2.3  PLACING  NODES  ON  THE  GRID 


To  place  a  node  at  a  certain  location  on  the  grid— i.e.,  centered  on  that 
location — issue  the  PLACE  command  designating  (1)  the  type  of  node  to  be 
placed,  (2)  a  user-given  name,  and  (3)  horizontal  and  vertical  position 
coordinates.  One  can  also  opt  to  indicate  the  size  of  the  geometrical  shape 
if  the  default  value,  equal  to  the  number  of  characters  in  the  user-given 
name,  is  unsuitable.  To  center  a  square  named  N0DE1  twenty  units  from  the 
left-hand  side  and  thirty  units  from  the  bottom  in  figure  7  above,  type 

PLACE  SQR, NODE 1,20, 30 

Figure  9  shows  the  screen  display  that  would  result  from  this  command. 


HOft  ■  LEFT  0,  UF  V 


Figure  9.  Architectural  Grid  With  a  Single  Node 


All  nodes  are  placed  In  this  way.  To  place  nodes  in  the  positions  shown  in 
figure  10,  type  the  following  sequence  of  commands  ("P"  is  an  abbreviation  for 
"PLACE"): 

P  TTY,NODE2 ,15,10 

P  PRP.N0DE3 ,45,30 

P  TRI ,NODE4 ,70 , 10 

P  TAP.NODE5 ,45 , 15 

P  CRD,NODE6,75,35 


HOME  «  LEFT  0,  UP  0 


Figure  10.  Six  Nodes  on  an  Architectural  Grid 
2.4  CONNECTING  NODES 


The  second  step  in  creating  a  system  architecture  is  the  placement  of  connec¬ 
tions  between  the  nodes.  The  CONNECT  command  is  used  to  connect  two  nodes. 
Such  connections,  or  "links",  are  defined  by  specifying  (1)  the  node  from 
which  the  link  is  to  run,  (2)  the  node  to  which  the  link  is  to  run,  and  (3)  a 
user-given  name  of  the  link.  To  place  a  link  called  "LINK1"  from  NODEl  to 
NODE2,  type 

CON  NODEl ,N0DE2,LINK1 

This  command  places  a  cursor  at  NODEl  if  the  user  is  on  an  HP  terminal,  or  in 
the  lower  left  corner  if  the  user  is  on  a  TEK  terminal;  typing  any  alpha¬ 
numeric  character  other  than  a  period  causes  a  straight  line  to  be  drawn 
between  the  centers  of  the  two  nodes,  thereby  drawing  the  link.  The  graphic 
result  is  shown  in  figure  11. 


17 


£ 


HOME  »  LEFT  0,  UP  0 


Figure  11.  Architecture  with  One  Link  Defined 
Links  need  not  always  appear  as  straight  lines,  as  is  shown  in  figure  12. 
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To  create  links  that  bend,  enter  the  CON  command  as  above.  Then  using  the  1 

graphics  cursor  controls  on  the  terminal  (either  the  arrow  keys  on  the  HP  i 

terminals  or  the  joystick  button  on  the  TEK  terminal),  the  cursor  can  be  moved  | 

to  the  spot  where  the  link  is  to  bend.  When  the  cursor  is  at  the  point  of  the  ' 

bend,  type  in  a  period  (.).  If  no  further  bending  is  desired,  typing  any 

other  non-period  alphanumeric  character  will  complete  the  connection.  The  j 

resulting  connection  will  resemble  the  one  depicted  above  in  figure  12. 

i 

Links  may  be  given  more  than  one  bend  by  repeating  the  sequence  of  moving  the  | 

cursor  and  typing  a  period  (.),  and  then  depressing  any  non-period  character 
only  when  all  the  desired  bends  (up  to  5  bends,  i.e.,  six  segments)  have  been 
created. 

To  create  the  links  shown  in  Figure  13,  type  the  following  sequence  of 
commands: 

CON  NODE1 ,NODE4 , LINK 4 
CON  NODE3 , NODE6 , LINK3 
CON  NODE3.NODE5, LINKS 

NOTE:  If  the  user  is  logged  on  through  a  VT100  terminal,  there  is  no 
capability  to  create  bent  links.  All  connections  are  automatically  made  as 
straight  lines  between  the  two  nodes. 
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Figure  13.  Architecture  with  Four  Links 


2.5  CHANGING  THE  SIZE.  TYPE,  AND  NAME  OF  NODES  AND  LINKS 


The  size,  type,  or  name  of  nodes  and  the  names  of  links  can  be  changed  using 
the  CHANGE  command.  By  typing  the  following  commands,  nodes  and  links  may  be 
altered: 

CHG  NAME, NODE 1 .NODEX 
CHG  TYPE,N0DE2,L0D 
CHG  SIZE,N0DE3,7 
CHG  NAME.LINK4 ,LINKZ 

The  user  may  note  the  changes  on  his  screen.  By  typing  the  following 
commands,  the  architecture  is  returned  to  its  original  configuration: 

CHG  NAME, NODEX, NODE 1 

CHG  TYPE, NODE2, TTY 

CHG  SIZE.NODE3.5 

CHG  NAME.LINKZ.LINK4 

As  mentioned  earlier,  Resource  entities  are  created  by  the  AISIM  system  to 
model  the  architecture  elements.  When  the  name  or  type  of  a  node  is  changed 
or  the  name  of  a  link  is  changed,  the  appropriate  changes  are  also  made  to  the 
associated  Resource  entitles.  That  is,  when  a  node  or  link  name  is  changed, 
the  associated  Resource  name  is  changed.  When  the  type  of  a  node  is  changed, 
new  attributes  may  replace  the  existing  attributes  of  the  Resource  since 
different  attributes  may  be  defined  for  the  new  symbol  type.  Refer  to  Section 
2.2  of  this  manual. 

2.6  DELETING  NODES  AND  LINKS 


Existing  nodes  and  links  may  be  deleted  from  a  system  architecture  with  the 
DELETE  command.  For  this  example,  to  eliminate  the  connection  between  N0DE1 
and  N0DE2  type 

DELETE  LINK1 

The  result  on  the  screen  would  be  that  the  link  named  "LINK1 "  would  disappear. 

When  a  node  is  deleted,  all  of  the  links  associated  with  it  also  disappear. 

As  an  example  type 

DELETE  N0DE6 

The  result  of  deleting  LINK1  and  N0DE6  is  shown  in  figure  14.  Note  that  LINK3 
disappeared  also. 
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Figure  14.  The  Result  of  Deleting  LINK1  and  N0DE6 


2.7  MOVING  PREVIOUSLY  PLACED  NODES 

The  location  of  a  node  on  the  architecture  grid  may  be  changed  with  the  MOVE 
command.  For  example,  to  move  NODE4  from  Its  current  position  to  the 
coordinates  55,5  one  Issues  the  command: 

MOVE  NODE4,55,5 

The  graphic  result  Is  shown  In  figure  15.  The  symbol  is  now  centered  at  55,5 
with  all  of  its  previously  defined  connections  intact. 


Figure  15.  The  Result  of  Moving  N0DE4 


2.8  RECONNECTING  EXISTING  LINKS 

The  previous  example  of  moving  N0DE4  created  a  problem  that  can  be  solved  with 
the  command  RECON.  As  figure  15  shows,  the  link  between  N0DE1  and  N0DE4  now 
runs  through  NODE5.  The  connection  can  be  made  to  bend  around  N0DE5  by  first 
typing 

RECON  LINK4 

This  command  will  delete  the  existing  graphics  for  the  link  between  N0DE1  and 
N0DE4  and,  as  in  the  original  CONNECT  command,  place  the  cursor  at  NODE1 . 

Using  the  sequence  of  cursor  movements  and  periods  (.)  described  in  section 
2.4,  up  to  five  bends  in  the  existing  connection  between  NODE1  and  N0DE4  can 
be  created.  To  complete  the  connection,  type  any  non-period  character.  The 
graphic  result  will  be  something  like  that  shown  In  figure  16. 
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Figure  16.  Architecture  After  Reconnecting 


NOTE:  The  same  restriction  applies  to  the  RECON  command  as  the  CONNECT 
command  when  the  user  is  logged  on  to  a  VT100  terminal;  i.e.,  only  one-segment 
connections  are  allowed  (see  section  2.4). 


2.9  ALTERING  ONE’S  VIEW  OF  THE  ARCHITECTURE  GRID 


The  usable  grid  space  in  ADE  is  actually  larger  than  what  can  be  displayed  on 
the  terminal  screen  at  one  time.  If  an  architectural  design  is  too  large  for 
the  screen  to  accommodate,  different  parts  of  the  total  workspace  can  be 
viewed  and  manipulated  through  the  WINDOW  command.  The  WINDOW  command  allows 
the  directional  change  of  the  user's  view  of  the  grid.  The  command  specifies 
the  direction  of  change — up,  down,  right  or  left— ‘as  well  as  the  number  of 
grid  units  the  view  is  to  be  changed. 


For  example,  to  move  the  view  of  the  screen  in  figure  16  down  15  units,  type 


WINDOW  D, 15 

Figure  17  shows  the  result  of  this  command. 


23 


§ 


•> 

v 


& 


*■ 


3 


a 


3 


a 


$ 

J 


% 


HOME  x  lE'T 


(. )  0“  1  ‘ 


ulf#5 

I 

■  N0C<£5  x_ 


-  0  1  1  c  2  3  3  -  4  5  », 

••  -  '3  5  0  5  O  5  O  5  0  3  6 


o  *  •:•  5  o 


Figure  17.  Result  of  WINDOW  Command 


The  WINDOW  command  will  accomplish  both  horizontal  and  vertical  movements  at 
the  same  time.  To  move  our  view  of  the  screen  further  down  15  units  and  20 
units  to  the  right,  type 


WINDOW  D, 15,R, 15 


Figure  18  shows  the  result  of  this  command. 
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Figure  18.  The  Result  of  Further  Use  of  WINDOW 


Note  that  the  WINDOW  command  parameters  required  to  get  back  to  the  original 
(HOME)  position  are  always  displayed  above  the  upper  right  corner  of  the 
architecture  grid. 

2.10  DEFINING  LEGAL  PATHS 

The  purpose  of  the  Architecture  facility  is  to  specify  routes  of  communication 
between  hardware  elements  so  that  Process  execution  will  be  realistically 
related  to  the  physical  layout  of  a  system.  Such  routes  are  represented  by  a 
Legal  Path  Table  which  specifies  the  links  and  the  nodes  through  which 
communication  from  one  node  to  another  must  take  place.  There  are  several 
methods  of  defining  a  Legal  Path  Table  (LPT).  Three  methods  are  offered  to 
the  user  at  the  end  of  an  ADE  session.  These  methods  are  predefined 
algorithms  for  the  definition  of  an  LPT  which  can  be  executed  optionally  at 
the  user's  discretion.  See  the  AISIM  User's  Manual  section  6.3.19  for  details 
of  how  these  algorithms  function.  For  many  architectures  It  is  more 
economical  to  create  the  Legal  Path  Table  while  defining  the  configuration  of 
hardware  elements  rather  than  using  the  algorithms  mentioned  above.  If  an  LPT 
is  generated  according  to  the  following  discussion,  the  predefined  algorithms 
should  be  bypassed  since  they  would  erase  the  LPT  so  defined. 

Suppose  we  augment  the  architecture  developed  above  with  more  links  so  that  it 
resembles  that  shown  in  figure  19. 
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Figure  19.  Augmented  Architecture 


The  LPT  is  defined  by  means  of  the  command  DEFINE  PATH.  If,  for  example, 

NODE1  is  to  communicate  with  NODEA  along  the  communication  lines  represented 
by  the  links  LINK3,  LINKS,  and  LINK2,  type 

DEFINE  PATH , N0DE1 , NODEA , LINK3 , LINKS , LINK2 

No  confirmation  will  be  displayed  Immediately  at  the  screen,  but  the  Legal 
Path  Table  will  have  been  augmented  to  reflect  the  new  paths.  However,  the 
command  LIST  PATH  enables  the  user  to  inspect  the  Legal  Path  definitions 
currently  in  effect.  To  obtain  a  listing  at  the  screen  of  the  legal  path  from 
N0DE1  to  NODEA,  type 

LIST  PATH, NODE 1 , NODEA 

The  resulting  list  is  shown  in  the  upper  right-hand  corner  of  figure  20. 


Figure  20.  Typical  List  of  Legal  Paths  Obtained  in  ADE 


Note  that  paths  front  NODE3  and  NODES  to  N0DE4  have  been  automatically  defined 
by  the  preceding  DEFINE  PATH  command.  The  principle  is  that  any  time  a  legal 
path  Is  defined  through  a  number  of  nodes,  the  AISIM  system  creates  legal 
paths  from  all  nodes  through  which  the  path  passes  to  the  destination  to  node. 
Care  should  be  taken  In  defining  subsequent  legal  paths  according  to  this 
method.  Any  conflicts  of  path  routing  in  paths  defined  later  would  result  In 
the  elimination  of  previously  defined  paths.  Following  is  an  illustration  of 
this  operation  of  the  system.  Assume  that  the  path  has  been  created  as  above. 
If  the  user  should  now  enter  the  command: 

DEFINE  PATH, NODE2.NODE4, LINK  1 .LINK 4 

not  only  would  the  path  from  N0DE2  to  N0DE4  be  established,  but  the  path  from 
N0DE1  to  NODE4  would  be  altered  to  be  the  direct  path  via  LINK4.  The  paths 
defined  automatically  from  the  previous  command  (l.e.,  the  paths  from  nodes 
N0DE3  and  N0DE5  to  N0DE4)  would  still  exist  since  there  was  no  conflict  with 
these  paths  and  the  newly  defined  path. 
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3.  DEFINING  PROCESSES  IN  THE  DUI 


Whereas  the  Architecture  Design  Editor  (ADE)  is  used  to  represent  the  physical 
layout  of  a  system,  the  Process  Editor  Interface  (PEI)  is  used  to  represent 
the  logic  and  data-handl ing  behavior  of  processes  in  the  system. 

This  section  provides  examples  to  familiarize  the  user  with  the  commands  and 
prompts  used  in  the  PEI.  Earlier  the  user  was  urged  to  begin  the  design  of  an 
AISIM  model  with  sufficient  research  and  planning  to  fully  understand  the 
system  to  be  modeled.  However,  as  a  teaching  device,  we  shall  develop 
fragments  of  a  Process  from  requirements  formulated  as  we  go  along. 

The  exercises  here  are  intended  both  to  deepen  the  user's  grasp  of  the  Process 
Primitives  and  to  familiarize  him  with  the  prompts  encountered  while 
interacting  with  the  PEI. 

Assuming  the  user  has  just  completed  the  foregoing  section,  entered  an  END 
command  to  exit  the  ADE  sublevel,  and  another  END  command  to  bypass  the  LPT 
generation,  he  will  be  at  the  DUI  level  of  operation.  A  should  be 
displayed.  To  invoke  the  PEI  sublevel  of  the  DUI,  one  enters  the  EDIT  PROCESS 
command  designating  the  name  of  the  Process  to  be  edited.  Once  in  the  PEI, 
the  user  can  terminate  the  PEI  session  by  entering  an  END  command. 

Consider  first  the  simplest  Process  that  could  be  of  any  use  to  the  modeler  of 
a  system:  the  Process  starts,  a  certain  amount  of  time  is  taken  with  an 
Action  and  then  the  Process  ends.  This  Process  will  be  represented  in  AISIM 
by  the  START  symbol,  the  ACTION  Primitive  and  the  END  symbol.  To  represent 
such  a  Process  in  AISIM,  one  begins  by  issuing  the  command 

EDIT*  PROCESS, EXAMPLE, NEW 

which  informs  the  system  that  one  wishes  to  create  a  Process  named  "EXAMPLE”. 
To  alter  a  Process  that  has  been  previously  defined,  one  would  not  enter  the 
"NEW"  part  of  the  command.  The  computer  will  respond  with  a  form  to  be  filled 
in  at  the  terminal.  This  is  done  by  typing  into  the  fields  provided  in  the 
form.  The  form  is  shown  in  figure  21. 


START 


ATTRIBUTES  ATTACHED  (YES  OR  NOJ 
PROCESS  DESCRIPTION 


START  BLOCK  TYPE 


ENTER  “PARM"  FOR  PARAMETER  PASSING 
ENTER  "ITEM"  FOR  ITEM  PASSING 
ENTER  "STD  "  FOR  STANDARD  PROCESS 


Figure  21.  Initial  Form  for  Process 


The  NODE  field  asks  for  the  node  in  the  architecture  with  which  the  Process  is 
associated.  Since  this  Process  is  not  yet  related  to  an  architecture,  the 
field  Is  left  blank.  The  next  field  allows  the  assignment  of  attributes  to 
the  Process.  For  the  present,  we  shall  decline  to  do  so.  The  field  labeled 
PROCESS  DESCRIPTION  is  for  a  comment  to  describe  the  Process.  In  this  case, 
type  "Example  Process’*. 

Depress  the  key  that  enters  the  form  (see  appendix  A  for  specific  key).  The 
screen  will  go  blank  for  a  moment  and  then  display  the  image  depicted  in 
figure  22. 


Figure  22.  Graphic  Display  That  Follows  Entering  a  Standard  Process 


Much  of  the  information  you  entered  on  the  form  now  appears  in  this  graphic 
representation  of  EXAMPLE.  The  "NO"  to  the  right  of  the  START  symbol 
Indicates  the  the  Process  has  no  attached  attributes. 
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3.1  PROCESS  EDITOR  DRAW/NODRAW  MODES 

The  Process  editor  maintains  DRAW  and  NODRAW  modes  similar  to  the  Architecture 
Design  Editor  except  that  both  DRAW  and  NODRAW  modes  are  available  for  all 
terminal  types  in  the  Process  Editor.  If  the  user  is  in  DRAW  mode,  changes 
made  to  any  Primitives  will  cause  the  specifically  affected  Primitives  to  be 
redrawn,  or  the  entire  screen  will  be  redrawn  if  the  affected  Primitive  is  off 
the  screen.  If  the  entire  screen  is  redrawn,  the  changed  Primitive  is  placed 
at  screen  position  three.  If  the  user  is  in  NODRAW  mode,  then  any  changes  to 
Primitives  will  not  cause  the  screen  to  be  updated  until  a  REDRAW  command  is 
entered,  which  will  cause  the  display  containing  the  most  recently  changed 
Primitive  to  be  redrawn.  The  user  can  also  use  the  commands  TOP,  BOTTOM,  UP 
and  DOWN  to  cause  the  display  to  be  redrawn  at  a  different  location. 

The  default  mode  for  the  Process  Editor  is  DRAW  mode.  The  user  can  switch  to 
NODRAW  mode  or  back  to  DRAW  mode  by  entering  the  command  NODRAW  or  DRAW.  The 
following  discussions  assume  the  user  in  DRAW  mode. 

3.2  ACTION 

To  place  an  ACTION  Primitive  between  the  Start  and  the  End  symbols,  enter  the 
command 

P  ACTION 

which  tells  the  computer  to  place  an  ACTION  Primitive  between  the  last 
Primitive  defined  and  the  END  symbol.  The  computer  will  now  display  a  new  form 
to  be  filled  in.  This  is  shown  in  figure  23. 


PARAMETERS  FOR  ACTION 
ACTION  NAME: 

MEAN  TIME: 

COMMENT: 


OPTION: 
DELTA  TIME: 


METHOD: 

|  units:  agrairai 


Figure  23.  Form  for  the  ACTION  Primitive 
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The  field  ACTION  NAME  requests  a  name  for  the  Primitive  in  the  Process,  which 
should  be  identical  with  the  name  of  the  associated  Action  entity.  (If  it 
does  not  exist,  the  ACTION  entity  will  be  created  along  with  the  ACTION 
Primitive.  Action  entities  are  described  in  section  4.1.)  We  shall  call  it 
“Delay".  The  field  COMMENT  is  a  place  to  write  a  short  reminder  of  what  the 
ACTION  Primitive  is  supposed  to  represent.  The  three  fields  METHOD,  MEAN 
TIME,  and  DELTA-TIME  enable  the  user  to  vary  the  time  taken  up  by  the  ACTION 
by  invoking  various  statistical  distribution  methods  (such  as  exponent, 
uniform,  etc.  See  section  3.9.1  of  the  AISIM  User's  Manual  for  a  description 
of  the  valid  distributions.)  Assume  that  the  ACTION  always  requires  the  same 
amount  of  time,  and  hence  the  MEAN  TIME  requested  will  be  equal  to  the 
duration  of  the  ACTION.  Indicate  the  time  with  a  variable  whose  value  for 
this  example  is  specified  elsewhere,  calling  it  “Tl”.  The  field  OPTION 
specifies  that  the  ACTION  will  be  resumed,  rather  than  restarted  if  it  is 
interrupted.  The  field  UNITS  states  that  the  unit  of  time  is  seconds. 

The  form  should  then  be  filled  in  thus:  call  the  ACTION  "Delay",  set  the 
method  at  “Constant”,  and  set  the  MEAN  TIME  at  ”T1“.  Type  the  comment  field 
"Action  which  causes  delay".  Leave  the  field  labeled  DELTA  blank  and  let  the 
OPTION  and  UNITS  fields  default  to  the  displayed  values.  After  leaving  the 
form,  the  screen  will  display  a  new  version  of  EXAMPLE,  as  depicted  in  figure 
24. 


Figure  24.  Process  with  a  Single  ACTION 


3.3  HOLD 


EXAMPLE  may  be  augmented  in  a  number  of  ways.  For  example,  the  ACTION  Delay 
may  be  repeated  in  succession.  There  are  two  ways  to  repeat  this  ACTION  in  a 
revised  version  of  EXAMPLE.  First,  one  can  place  more  copies  of  Delay  in  the 
Process,  one  after  another,  with  the  command 


P  ACTION 
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This  command  may  be  repeated  as  many  times  as  one  wishes  the  Action  to  be 
performed  in  the  Process.  The  second  method  of  creating  several  instances  of 
an  ACTION  which  is  less  time-consuning,  involves  the  HOLD  storage  area.  HOLD 
constitutes  a  storage  area  for  Primitives  that  are  likely  to  be  used  more  than 
once  with  little  or  no  alteration.  To  place  a  previously  defined  Primitive 
into  HOLD,  type 

HOLD  2 

The  number  2  represents  the  position  in  the  Process  of  the  Primitive  to  be 
stored  In  HOLD.  The  position  is  Indicated  by  the  numbers  in  the  column  on  the 
left.  Hereafter,  the  ACTION  Primitive  "Delay"  may  be  placed  in  a  Process  by 
typing 

P  HOLD 

Each  time  this  latter  command  is  issued,  the  user  will  be  presented  with  the 
form  associated  with  the  Primitive  in  case  any  small  alterations  in  its 
parameters  are  to  be  made.  Whether  or  not  any  alterations  are  made,  leaving 
the  form  will  result  in  the  placement  of  the  Primitive  stored  in  HOLD  in  the 
Process  being  edited. 

Figure  25  shows  the  display  that  will  appear  after  several  identical  ACTION 
Primitives  have  been  placed  in  succession  or  after  the  HOLD  storage  area 
containing  the  ACTION  "Delay"  has  been  placed.  The  procedure  of  repetition 
will  occur  as  many  times  as  the  user  requests  it. 
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Figure  25.  Process  with  Three  Identical  ACTION  Primitives 


3.4  ENTRY  AND  LOOP 


If  the  ACTION  “Delay”  is  to  be  performed  a  certain  n  number  of  times,  as  in 
the  most  recent  version  of  EXAMPLE,  a  much  simpler  procedure  is  available  than 
that  of  placing  n  instances  of  the  ACTION  between  the  START  and  END  symbols. 
One  can  Instead  indicate  more  directly  that  a  certain  part  of  a  Process  is  to 
repeat  itself  an  n  number  of  times.  This  is  accomplished  by  means  of  the 
Primitives  LOOP  and  ENTRY.  Figure  26  shows  EXAMPLE  altered  with  LOOP  and 
ENTRY  Primitives  to  cause  a  triple  repetition  of  the  ACTION  “Delay”. 


Figure  26.  Process  with  Triple  Repetition  of  the  ACTION  Delay 


The  diamond-shaped  figure  indicates  that  the  line  of  processing  is  to  be 
diverted  to  the  point  labled  "Return"  above  it  (it  could  have  been  given  any 
label  whatever  up  to  8  characters). 

To  effect  the  LOOP  Primitive  as  shown  in  figure  26,  we  must  first  get  rid  of 
the  two  extra  ACTION  Primitives.  This  is  done  by  typing  the  following 
commands: 

DELETE  3 

DELETE  3 

P  LOOP 


The  screen  will  show  the  form  shown  in  figure  27 


PARAMETERS  FOR  LOOP: 


LOOP  TO  LABEL:  |gg | 
LOOP  HHI|  TIMES 
COMMENT : 


Figure  27.  Form  for  the  LOOP  Primitive 


The  first  field  asks  for  the  name  of  the  entry  point  to  which  Process  control 
is  to  be  diverted.  The  second  asks  for  the  number  of  times  the  primitives 
between  the  ENTRY  and  the  LOOP  are  to  be  performed  (i.e.,  control  will  be 
diverted  to  the  entry  point  one  less  time  than  the  number  since  the  steps  will 
have  been  executed  once  already  when  the  LOOP  is  reached).  The  remaining 
field  is  self-explanatory. 

The  ENTRY  Primitive  must  now  be  placed  above  the  ACTION  Primitive.  Since  the 
PLACE  (or  "P")  command  by  default  inserts  the  new  Primitive  just  before  the 
END  symbol,  a  modified  PLACE  command  is  required  to  place  a  Primitive 
elsewhere  in  the  sequence.  To  use  this  command,  type 

P  ENTRY, 2 

The  number  "2“  indicates  where  the  Primitive  is  to  be  placed,  in  reference  to 
the  column  of  numbers  on  the  left  of  the  Process  diagram. 

The  screen  will  then  display  the  form  shown  in  figure  28. 

PARAMETERS  FOR  ENTRY: 

ENTRY  LABEL: 

COMMENT: 


Figure  28.  Form  for  the  ENTRY  Primitive 


The  label  will,  in  this  case,  be  determined  by  the  LOOP  label  previously 
defined.  The  ENTRY  LABEL  field  should  be  entered  exactly  as  in  the  LOOP 
LABEL,  i.e.,  as  "Return”.  Type  an  appropriate  comment  in  the  field  provided, 
such  as,  "Entry  From  Loop  Below".  The  result  should  be  as  in  figure  26. 

3.5  PROB,  TEST,  COMPARE  AND  BRANCH 


Four  other  Primitives,  PROB,  COMPARE,  BRANCH,  and  TEST  are  similar  to  LOOP  in 
that  they  represent  a  branching  to  an  ENTRY  Primitive.  EXAMPLE  may  be  altered 
in  the  following  four  ways. 


3.5.1  PROB.  The  PROB  Primitive  is  used  to  indicate  that  the  re-execution  of 
the  ACTION  "Delay"  has  only  a  certain  degree  of  probability. 

Since  AISIM  has  no  command  for  directly  replacing  one  Primitive  with  another, 
the  existing  Primitive  LOOP  must  first  be  deleted. 

Enter  the  command 

DEL  4 

where,  as  before,  ”4”  indicates  the  location  of  the  Primitive  to  be  deleted. 
Figure  29  shows  the  display  produced  when  the  LOOP  Primitive  is  deleted. 

"DEL"  is  an  abbreviation  for  "DELETE". 


Figure  29.  EXAMPLE  after  Deletion  of  LOOP  Primitive 

The  PLACE  command  is  used  to  insert  a  PROB  Primitive  between  the  ACTION 
"Delay”  and  the  END  symbol.  Type 

P  PROB 

The  screen  will  offer  the  form  shown  in  figure  30. 

PARAMETERS  FOR  PROBABILISTIC  BRANCH: 

BRANCH  TO  LABEL: 

PROBABILITY  OF  BRANCH :  ■■■'• 

COMMENT: 


Figure  30.  Form  for  PROB  Primitive 


Complete  the  first  field  with  "Return".  The  second  field  should  be  filled  in 
with  the  probability  of  branching,  given  as  a  percentage.  Suppose  there  is  a 
252  chance  of  branching.  Type  the  appropriate  comment,  "252  chance  of 
branching".  The  resulting  display  diagram  is  given  in  figure  31. 


Figure  31.  Process  with  Probabilistic  Branch 


3.5.2  TEST.  Another  kind  of  branching  Primitive  is  TEST.  As  mentioned 
earlier.  Processes  often  make  use  of  Resources  for  which  there  is  competition. 
The  TEST  Primitive  represents  the  procedure  of  ascertaining  the  availability 
of  a  given  Resource  and  branching  if  that  Resource  is  not  available,  or 
continuing  if  it  is.  This  Primitive  does  not  allocate  the  Resource.  To  place 
the  TEST  Primitive  (after  having  deleted  the  PROB  Primitive  from  the  latest 
version  of  EXAMPLE),  type 

P  TEST 

The  screen  will  display  the  form  shown  in  figure  32. 

PARAMETERS  FOR  TEST: 

RESOURCE  NAME : 

BRANCH  TO  LABEL  IF  NOT  AVAILABLE 

COMMENT : 


Figure  32.  Form  for  TEST  Primitive 


In  the  RESOURCE  NAME  field,  type  the  name  of  the  Resource  whose  status  is  to 
be  ascertained.  The  LABEL  is  the  ENTRY  Primitive  to  branch  to,  COMMENT  is 
self-explanatory.  If  the  PROB  Primitive  in  the  previous  version  of  EXAMPLE  is 
replaced  by  TEST  (as  in  this  example),  EXAMPLE  will  now  appear  as  in  figure  33. 


(  START  ) 
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Figure  33.  Process  with  TEST  Branching 


3.5.3  COMPARE.  In  addition  to  probabilistic  branching,  AISIM  also  allows  for 
conditional  branching  less  specialized  than  the  TEST  Primitive.  Most  of  these 
branchings  will  require  the  COMPARE  Primitive.  The  COMPARE  Primitive  compares 
two  numerical  or  alphanumerical  values  with  respect  to  some  relation  and 
branches  to  a  named  ENTRY  Primitive  if  the  relation  holds. 

To  place  the  COMPARE  Primitive,  delete  the  previously  defined  TEST  Primitive 
and  type 

P  COMPARE 

The  screen  will  display  the  form  depicted  in  figure  34. 


PARAMETERS  FOR  COMPARE 


IF  OPERAND  1:1 


QUALIFIER  1 


RELATION  :| 

OPERAND 

BRANCH  TO: 

COMMENT 


QUALIFIER  2: 


Figure  34.  Form  for  COMPARE  Primitive 


The  fields  OPERAND  1  and  OPERAND  2  hold  the  parameters  whose  values  are  to  be 
compared.  The  values  may  be  represented  by  arbitrarily  chosen  names  of 
variables  (such  as  Varl  and  Var2).  They  are  compared  with  respect  to  the 
following  six  arithmetical  relations  indicated  by  the  two  letter  code: 


EQ 

for 

NE 

for 

GT 

for 

LT 

for 

GE 

for 

LE 

for 

"equal  to" 

"not  equal  to" 

"greater  than" 

"less  than" 

"greater  than  or  equal  to" 
"less  than  or  equal  to" 


The  BRANCH  TO  and  COMMENT  labels  are  now  self-explanatory.  The  two  QUALIFIER 
fields  serve  several  purposes,  the  most  important  of  which  is  to  allow  the 
comparison  of  attributes  of  entities  as  opposed  to  simple  variables  or 
numerics.  The  user  should  for  the  present  disregard  the  complication  posed  by 
these  fields  and  leave  them  empty.  Fill  in  the  OPERAND  fields  with  arbi¬ 
trarily  chosen  names  of  variables,  "Varl"  and  "Var2".  If  the  TEST  Primitive 
is  replaced  by  the  COMPARE  Primitive  with  the  foregoing  information  entered  on 
1 ts  form,  the  new  version  of  EXAMPLE  will  be  as  displayed  in  figure  35. 
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Figure  35.  Process  with  COMPARE  Primitive 


And  thus  EXAMPLE  Is  set  to  return  control  to  the  ENTRY  Primitive  If  the  value 
assigned  to  the  variable  Varl  is  less  than  the  value  assigned  to  the  variable 
Var2.  These  assignments  are  presumed  to  be  made  elsewhere. 

3.6  VARIABLE  MANIPULATION 

In  the  previous  example  of  the  COMPARE  Primitive,  note  that  if  the  condition 
solicited  is  true,  l.e.,  if  VAR1  was  less  than  Var2,  EXAMPLE  would  perform  the 
ACTION  "Delay"  indefinitely.  On  each  occasion  in  which  the  comparison  is 
made,  the  relation  will  hold  and  hence  the  Process  will  always  be  instructed 
to  branch  to  Return.  If  neither  variable  changes  its  value,  the  Process  will 
continue  until  it  is  halted  by  other  causes  (such  as  having  a  Resource 
necessary  to  it  allocated  elsewhere). 

Using  two  new  Primitives,  ASSIGN  and  EVAL,  we  can  alter  EXAMPLE  so  that  the 
ACTION  "Delay"  does  not  go  on  forever  but  only  for  a  certain  maximum  time 
("Maxtime”).  This  is  accomplished  with  the  ASSIGN  Primitive  which  introduces 
a  new  variable  for  the  accumulation  of  time  consumed  by  the  ACTION'S  execution 
times  and  by  the  EVAL  Primitive,  which  recalculates  the  value  of  this 
accumulated  time  each  time  the  ACTION  is  performed. 

First,  to  command  AISIM  to  place  an  ASSIGN  Primitive  between  the  START  and  the 
ENTRY,  type 

P  ASSIGN, 2 

The  screen  will  now  show  the  form  displayed  in  figure  36. 


PARAMETERS  POP  ASSIGN 


Figure  36.  Fora  for  ASSIGN  Primitive 

For  this  example  disregard  the  fields  labeled  Q1  and  Q2;  they  serve  the  same 
purpose  as  do  the  QUALIFIER  fields  in  the  COMPARE  Primitive.  The  purpose  of 
this  exercise  is  to  create  a  temporarily  useful,  local  variable,  which  we 
shall  call  “Acctime"  whose  value  represents  the  amount  of  time  that  has  been 
consumed  in  the  repeated  execution  of  "Delay”.  At  the  beginning  of  the 
Process  the  initial  value  of  the  variable  will  be  zero.  Hence,  complete  the 
VI  field  with  ”0”  and  the  V2  field  with  " Ac c time” .  When  this  Information  is 
entered,  the  screen  will  display  the  graphic  representation  shown  in  figure  37. 


Figure  37.  Process  with  Primitives  ASSIGN,  ACTION,  and  COMPARE 


To  provide  an  apparatus  for  updating  the  variable  “Acctirae"  on  each  occasion 
of  the  ACTION'S  execution,  an  EVAL  Primitive  must  be  placed  between  the  ACTION 
and  COMPARE  Primitives.  To  do  this,  type 


P  EVAL, 5 

The  screen  will  display  the  form  shown  in  figure  38. 


PARAMETERS  FOR  EOAL 
SET  UARIAOLE^mH 
ARITHMETIC  EXPRESSION t 


COMMENT 


Figure  38.  Form  for  EVAL  Primitive 


The  SET  VARIABLE  field  holds  the  name  of  the  variable  whose  value  is  to  be 
calculated.  The  ARITHMETIC  EXPRESSION  field  contains  up  to  four  lines  of  a 
free-form  expression  whose  result  is  assigned  to  the  variable  in  the  SET 
VARIABLE  field  (see  AISIM  User's  Manual,  section  3.9.12).  Type  an  appropriate 
comment,  such  as  '‘Evaluating  Acctime".  The  graphic  representation  of  EXAMPLE 
will  be  as  shown  in  figure  39. 
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Figure  39.  Process  with  ASSIGN,  ACTION,  COMPARE,  and  EVAL 

This  Primitive  adds  the  current  value  of  the  variable  "Tl"  to  the  value  of 
“Acctime",  producing  an  updated  figure  for  the  total  time  consumed  by  ’’Delay". 

The  Process  still  requires  alteration.  The  variables  presently  in  the  COMPARE 
Primitive  must  be  changed  from  Varl  and  Var2,  respectively,  to  ’’Acctirae"  and 
"Maxtime".  To  do  this,  we  must  edit  the  COMPARE  Primitive  by  typing 

C  6 

This  command  tells  AISIM  that  you  wish  to  alter  one  or  more  of  the  previously 
defined  parameters  in  the  Primitive  at  location  6.  The  screen  will  display 
the  form  for  the  Primitive.  It  can  be  altered  simply  by  writing  over  the 
existing  Information.  When  this  is  done  and  the  form  is  "entered",  EXAMPLE 
will  satisfy  the  specifications  for  its  alteration.  Its  graphic  representation 
will  be  as  in  figure  40. 
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Figure  40.  Process  with  Comparative  Branching 


3.7  ITEM  MANIPULATION 

Another  group  of  Primitives  is  categorized  under  the  headings  Queue  Handling 
and  Item  Handling.  These  include  CREATE,  DESTROY,  FILE,  FIND  and  REMOVE.  The 
Primitives  CREATE  and  FILE  will  be  used  in  this  example.  (Consult  the  AISIM 
User's  Manual  for  information  on  the  Primitives  DESTROY,  FIND  and  REMOVE.) 

Consider  the  first  version  of  EXAMPLE  which  consisted  of  the  single  ACTION 
Primitive  "Delay".  Suppose  now  that  we  conceive  of  EXAMPLE  as  a  Process  which 
gives  rise  to  new  data  elements — messages,  information,  potential  communica¬ 
tions.  This  function  of  the  Process  may  be  represented  by  means  of  the  CREATE 
Primitive,  which  represents  the  introduction  of  Items — the  AISIM  modeling 
entity  that  represents  transient  data  elements — into  the  modeled  system.  To 
place  the  Primitive  CREATE  below  the  ACTION  Delay  in  EXAMPLE  type 


P  CREATE 


The  form  for  CREATE  is  shown  in  figure  41 


PARAMETERS  FOR  CREATE 
ITEMS  TO  BE  CREATED  ARE: 


Figure  41.  Form  for  CREATE  Primitive 


Complete  this  form  with  the  names  of  the  Items  to  be  created.  Enter  the  Item 
name  "Msg"  and  an  appropriate  comment,  "Transient  Data  Element".  EXAMPLE  will 
now  appear  as  indicated  in  figure  42. 
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Figure  42.  Item  Creating  Process 

Items — transient  data  elements — can  also  be  filed  in  holding  areas  called 
Queues  with  the  FILE  Primitive.  To  place  a  FILE  Primitive  below  the  CREATE 
Primitive  in  EXAMPLE,  type 

P  FILE 

The  form  for  FILE  is  as  shown  in  figure  43. 
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PARAMETERS  FOR  FILE: 


FILE  ITEM  NAME: 
COMMENT: 


OPTION: 


ON  QUEUE: 


Figure  43.  Form  for  FILE  Primitive 


Complete  the  field  FILE  ITEM  NAME  with  "Msg".  The  OPTION  field  tells  where  in 
the  Queue  the  Item  is  to  be  placed.  This  location  is  specified  relative 
either  to  absolute  locations  on  the  Queue  ("FIRST"  and  "LAST”)  or  relative  to 
some  other  Item  already  on  the  Queue  ("BEFORE"  and  "NEXT”)*.  The  OPTION  field 
will  have  as  a  default  parameter  LAST.  In  the  ON  QUEUE  field  enter  "Msg_que". 
The  graphic  representation  of  this  Process  is  indicated  in  figure  44. 


START  \ 

( 

£  -IC-UE 


. 

l: _ 

: e.-v  j 

iT1 

i 

. 

; 

-  •  -£ 

.  f !  E  0  Lm':T 

'  vh  'i'JE  .. 


;  1 


:nd 


Figure  44.  Process  which  Creates  and  Files  Message  Items 


*The  method  by  which  the  system  identifies  the  Item  relative  to  which  other 
Item  is  to  be  placed  on  a  Queue  (with  the  OPTION  BEFORE  or  NEXT)  need  not 
concern  us  here.  For  more  on  this,  see  AISIM  User's  Manual,  section  3.9.13. 
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3.8  RELATIONS  AMONG  PROCESSES 


This  section  deals  with  the  relationships  that  the  execution  of  Processes  bear 
to  one  another  in  an  AISIM  Model,  and  how  one  Process,  and  its  execution, 
affects  the  execution  of  another.  Processes  affect  one  another's  execution  in 
four  ways: 

1.  By  sending  Items  that  trigger  the  execution  of  another  Process. 

2.  By  triggering  the  execution  of  another  Process  through  a  CALL  Primitive 
where  the  CALL  may  or  may  not  pass  parameters. 

3.  By  competing  for  and  obtaining  use  of  a  Resource  needed  by  another 
Process. 

4.  By  resuming  (with  the  RESUME  Primitive)  a  Process  which  at  some  time 
suspended  Itself. 

To  understand  how  parameter  and  Item  "passing"  affect  the  execution  of  a 
Process,  consider  the  form  completed  in  the  first  version  of  EXAMPLE.  In  the 
form  presented  as  a  result  of  the  command  to  edit  a  Process  (i.e.,  E 
PROCESS, EXAMPLE, NEW),  in  the  START  field  TYPE,  the  choices  included  "STD", 
"PARM"  and  "ITEM",  standing  for,  respectively,  "standard",  "parameter-passing" 
and  "Item-passing".  These  options  are  distinguished  from  one  another  in  the 
following  way.  A  Process  can,  before  it  is  fully  designed,  be  thought  of  as  a 
"black  box"  whose  internal  workings  are  unknown.  If  the  Process  is  conceived 
to  be  one  that  performs  its  function  without  having  to  be  given  anything  in 
the  way  of  information  or  data  elements  it  will  be  a  standard  Process.  If  the 
Process  requires  certain  data  elements— -discrete,  countable  entities — in  order 
to  execute,  then  it  is  an  "Item-passing"  Process.  Finally,  if  the  Process 
uses  values  of  variables  local  to  another  Process,  it  is  a  parameter-passing 
Process. 

For  the  first  example,  consider  Item  Passing  Processes.  In  this  exercise, 
delete  the  FILE  and  CREATE  Primitives  from  EXAMPLE.  To  change  EXAMPLE  from  a 
standard  Process,  as  it  now  is,  to  an  Item-passing  Process,  type 

C  1 

The  screen  will  display  the  form  originally  filled  out  for  EXAMPLE.  Type 
"ITEM"  over  the  existing  "STD"  in  START  field  TYPE.  Entering  this,  the  screen 
will  now  show  this  secondary  form  on  which  Items  needed  by  this  Process  are  to 
be  typed,  as  shown  in  figure  45. 

hem  Fusing  start 
ITEMS  FECEI'-ED: 
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Figure  45.  Secondary  Form  for  Process 


Type  the  single  Item  name  ''Msg"  in  the  upper  left  field  and  type  "N"  in  the 
match  field.  Entering  this  changes  the  Process  representation  so  that  it 
appears  as  in  figure  46. 


Figure  46.  Item  Passing  Process 

The  figure  to  the  left  of  the  START  figure  indicates  that  the  Process  starts 
when,  and  only  when,  the  Item  MSG  is  delivered  to  it  from  some  other  Process. 

None  of  the  Primitives  in  the  categories  Item  Handling  and  Queue  Manipulation 
represents  the  delivery  of  Items  to  a  Process.  This  delivery  function  is 
accomplished  by  the  SEND.  To  exemplify  SEND,  a  new  Process,  called  "EXAMP_2", 
must  be  created.  EXAMP_2  triggers  the  execution  of  EXAMPLE  by  delivering 
Items  to  it.  For  this  example  consider  a  Process  identical  except  in  name  to 
the  original  EXAMPLE  with  the  single  ACTION  Delay  as  depicted  in  figure  47. 
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Figure  47.  Process  with  ACTION  Primitive 

Type  the  command 


P  SEND 


The  screen  will  display  the  form  shown  in  figure  48. 


PARAMETERS  FOR  SEND 


Figure  48.  Form  for  SEND  Primitive 

Complete  the  SEND  ITEMS  TO  field  with  "Example".  In  the  first  field  of  ITEMS 
TO  BE  SENT,  type  "Msg".  Enter  the  comment  "Sending  Messge  Item".  Figure  49 
shows  the  graphic  representation  of  the  Process  that  will  appear  on  the  screen. 


END 


Figure  49.  Graphic  Representation  of  EXAMP-2 


EXAMP_2  now  triggers  EXAMPLE  by  delivering  to  it  Items  required  for  its 
execution.  The  Item  is  automatically  created  by  the  SEND  Primitive.  An 
Item-passing  Process  may  only  be  initiated  through  the  SEND  Primitive  in  some 
other  Process,  although  the  Items  needed,  and  hence  the  Items  sent,  may  be 
distributed  among  several  Processes  or  several  stages  of  a  single  Process. 

3.9  RESOURCE  ALLOCATION 

As  mentioned  earlier,  Processes  in  an  AISIM  model  frequently  make  use  of 
Resources.  A  Resource  has  a  finite  capacity  which  will  limit  the  number  of 
Processes  it  can  accommodate  at  the  same  time.  The  five  Primitives  which 
relate  to  the  allocation  of  such  Resources  are  ALLOC,  DEALLOC,  RESET,  LOCK  and 
UNLOCK . 


ALLOC  and  DEALLOC  signal  the  allocation  and  deallocation  of  a  Resource  by  the 
Process  in  which  they  appear.  To  place  the  ALLOC  Primitive  above  the  ACTION 
Primitive  in  EXAMPLE,  type 


P  ALLOC, 2 

To  place  a  DEALLOC  Primitive  just  above  the  SEND  symbol  in  EXAMP-2,  type 
P  DEALLOC, 4 

The  forms  for  these  two  Primitives  are  shown  below  in  figure  50. 


PARAMETERS  FOR  ALLOCATE: 
ALLOCATE  RESOURCE  NAME: 
NUMBER  OF  UNITS  REQUESTED :j 
PARTIAL /ALL  ALLOCATION: 
ALLOCATION  PRIORITY: 
COMMENT: 


FaPTIhL 


PARAMETERS  FOR  DEALLOCATE: 
DEALLOCATE  RESOURCE  NAME: 
NUMBER  OF  UNITS  DEALLOCATED: 

COMMENT:  ■■■■■■ 


Figure  50.  Forms  for  Primitives  ALLOC  and  DEALLOC 


In  each  case,  enter  the  name  of  the  Resource  to  be  allocated  or  deallocated, 
such  as  "Cpu",  in  the  field  provided.  The  field  NUMBER  OF  UNITS  REQUESTED 
holds  the  number  of  units  of  this  Resource  to  be  allocated  or  released.  The 
PARTIAL/ALL  field  specifies  the  type  of  allocation  scheme.  Partial  allocation 
will  allocate  Resources  as  they  become  available.  All  allocation  means  all  of 
the  units  must  be  available  at  once.  The  ALLOCATION  PRIORITY  field  specifies 
the  priority  at  which  Resources  are  allocated.  Enter  "l"  for  number  of  units 
and  "SPrlorty"  for  priority.  "SPriorty"  means  to  use  the  priority  the  Process 
was  invoked  with.  Enter  the  appropriate  comment,  "Obtaining  Cpu"  or 
"Releasing  Cpu"  in  the  COMMENT  field. 


Placing  these  Primitives  in  EXAMP_2  (one  above  the  ACTION  and  one  below), 
produces  a  graphic  representation  like  that  shown  in  figure  51. 
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Figure  51.  Process  which  Allocates  and  Deallocates  a  Resource 

Allocating  a  Resource  does  not  normally  insure  the  uninterrupted  availability 
of  that  Resource  to  a  Process.  Any  Resources  may  be  usurped  by  an  ALLOC 
request  with  a  higher  priority.  If  the  Process  being  modeled  is  one  which, 
once  begun,  cannot  be  interrupted,  the  Primitives  LOCK  and  UNLOCK  must  be  use 

To  obtain  the  forms  for  these  Primitives, 

P  LOCK.n 

or 

P  UNLOCK, n 

where  n  is  the  position  in  the  Process  where  the  Primitive  is  to  be  placed. 
The  forms  for  these  Primitives  are  shown  in  figure  52. 


PARAMETERS  FOR  LOCK: 
COMMENT : 


PARAMETERS  FOR  UNLOCK: 

COMMENT:  ■■■■■ 


Figure  52.  Forms  for  Primitives  LOCK  and  UNLOCK 


These  Primitives,  if  placed  above  the  ALLOC  Primitive  and  below  the  DEALLOC 
Primitive  in  EXAMP_2  would  give  a  graphic  representation  like  that  shown  in 
figure  53. 
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Figure  53.  Process  with  Protected  Resources 


One  final  way  to  affect  a  Resource  is  through  the  RESET  Primitive.  It  is  used 
to  reset  the  capacity  of  a  Resource,  where  “capacity"  is  a  measure  of  the 
number  of  Processes  it  will  accommodate  (support)  at  one  time.  For  details  on 
its  use,  see  the  AISIM  User's  Manual,  section  3.9.20. 

3.10  CALL 

The  function  of  the  CALL  Primitive  is  similar  to  that  of  the  SEND  Primitive, 
but  whereas  the  SEND  Primitive  triggers  Item-passing  Processes,  the  CALL 
Primitive  triggers  both  standard  Processes  and  parameter-passing  Processes. 
Thus,  to  understand  how  CALL  works  requires  a  brief  discussion  of  parameter¬ 
passing  Processes. 

A  parameter-passing  Process  is  one  that  is  "given"  values  for  input  variables 
and  "returns"  values  for  output  variables.  To  create  a  paramater-passing 
Process,  one  would  type  "PARM"  in  the  field  START  TYPE  in  the  original  form 
for  Process.  Entering  this  Information  on  the  Process  form  yields  the 
secondary  form  shown  in  figure  54. 
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Figure  54.  Secondary  Form  for  Parameter-Passing  Process 

On  the  form  in  figure  54,  the  user  types  the  variables  whose  values  are  passed 
to  the  Process  and  the  variables  whose  values  are  passed  back. 

The  CALL  Primitive  values,  i.e.,  parameters,  are  passed  (given)  to  a  called 
Process  and  returned  to  the  calling  Process.  Parameter  passing  can  occur  only 
through  the  use  of  a  CALL  Primitive.  A  CALL  Primitive  is  placed  in  a  Process 
by  typing 

P  CALL 

The  form  for  CALL  is  shown  in  figure  55. 
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PARAMETERS  FOR  CALL 


CALLEC-PROCESS  NAME:  ■■■ 

WAIT /NOMA I T /BLOCK :  ggQQjQH  PRI&PITY: 


GIUEN: 


RETURNS : 

COMMENT : 


Figure  55.  Form  for  CALL  Primitive 


The  field  CALLED-PROCESS  NAME  asks  for  the  name  of  the  Process  to  be 
triggered.  The  field  PRIORITY  determines  the  priority  associated  with  the 
called  Process  which  may  be  used  in  cases  of  Resource  contention.  (It  can  be 
overridden  by  the  priority  specified  in  an  ALLOC  Primitive.)  The  GIVEN  and 
RETURNS  fields  hold  the  local  variables  whose  values  are  passed  to  and  from 
the  called  Process.  A  CALL  Primitive  may  trigger  a  standard  Process  and  hence 
these  fields  may  be  empty.  The  COMMENT  field  is  self-explanatory.  The  field 
labeled  WAIT /NOWAIT /BLOCK  determines  whether  the  calling  Process  will  wait  for 
the  called  Process  before  continuing  execution  or  will  continue  to  execute 
Independently  of  it.  The  reader  is  referred  to  the  AISIM  User's  Manual  for 
details  on  their  use. 


REMAINING  MODEL  ELEMENTS 


Although  the  Processes  and  the  Architecture  are  core  modeling  elements,  their 
specification  does  not  complete  the  task  of  model  construction.  They  must  be 
supplemented  by  definitions  of  other  elements.  These  elements  are  grouped 
into  two  categories.  The  first  category  consists  of  those  entities  explicitl 
referred  to  in  Processes,  namely,  Actions,  Constants,  (global)  Variables, 
Tables,  Queues  and  Resources.  The  second  category  consists  of  the  two 
entities  that  are  used  to  represent  the  impact  of  the  environment  on  the 
modeled  system.  All  these  remaining  entities  are  defined  at  the  DUI  level  of 
AISIM  operation. 

The  following  two  sections  briefly  describe  the  parameters,  significance  and 
principle  commands  associated  with  these  remaining  entities. 

U  . 1  ACTIONS 


Any  ACTION  Primitive  placed  in  a  Process  must  have  a  corresponding  Action 
entity  defined  outside  the  Process.  AISIM  automatically  creates  an  Action 
entity  whenever  the  user  places  an  ACTION  Primitive  in  a  Process.  However,  i 
the  user  wishes  to  change  the  description  for  the  Action  entity,  this  can  be 
accomplished  by  typing 

E  ACT I ON, ACT ION  NAME 

The  form  for  the  Action  entity  is  shown  in  figure  56. 


ACTION : 


DESCRIPTION: 


Figure  56.  Form  For  Action  Entity 


The  ACTION  field  should  hold  the  name  of  an  Action  referenced  in  some  ACTION 
Primitive.  The  field  DESCRIPTION  is  for  any  convenient  reminder  of  what  the 
Action  represents.  Normally  a  user  will  not  need  to  modify  Action  entities, 
and  their  maintenance  can  be  left  to  the  AISIM  system. 

4.2  RESOURCES 

As  mentioned  earlier,  any  Resource  mentioned  in  a  Process — through  the  ALLOC, 
DEALLOC,  or  RESET  Primitives — must  be  defined  separately  in  the  DUI.  To 
create  a  new  Resource,  type 

E  RESOURCE, NAME, NEW 

The  screen  will  display  the  form  shown  in  figure  57. 


RESOURCE  NAME: 


TOTAL  NUMBER  OF  UNITS:  | 
INITIAL  NUMBER  OF  UNITS: 
DESCRIPTION:  ■■■■I 
ATTRIBUTES 


NAME  UALUE  NAtlE  "ALUE 


Figure  57.  Form  For  Resource  Entity 


Complete  the  first  field,  RESOURCE  NAME,  with  the  name  by  which  it  is  referred 
in  any  Process.  The  fields  TOTAL  NUMBER  OF  UNITS  and  INITIAL  NUMBER  OF  UNITS 
Indicate,  respectively,  the  maximum  number  of  Processes  the  Resource  can 
accommodate  at  any  one  time  and  the  number  of  Processes  it  can  accommodate  at 
the  beginning  of  a  simulation  run  (i.e.,  before  being  Increased  or  decreased 
by  the  RESET  Primitive).  Enter  the  appropriate  numbers.  DESCRIPTION  has  its 
usual  function.  Type  an  appropriate  description  in  the  field  provided.  The 
fields  under  ATTRIBUTES  indicate  whether  the  Resource  has  any  attributes 
associated  with  it. 

Up  to  fifteen  attribute  names  may  be  entered  with  their  initial  values. 

Though  all  Resources  referred  to  require  separate  definitions,  some  Resources 
are  defined  automatically.  For  each  node  or  link  created  in  a  model's  network 
architecture,  a  Resource  definition  of  the  same  name  with  default  parameters 
is  automatically  written  into  the  database.  In  other  words,  all  nodes  and 
links  are  identified  with  Resources.  Thus,  after  an  architecture  has  been 
created,  the  commands 

E  RESOURCE, nodename 
or 

E  RESOURCE, linkname 

can  be  issued  without  having  to  indicate  that  the  Resource  entity  is  new  (with 
"NEW").  Typically,  however,  not  all  of  a  system's  Resources  will  be  repre¬ 
sented  in  the  architecture  and  not  all  of  the  Resources  automat  leal lv  created 


in  ADE  will  have  any  positive  role  in  the  operation  of  the  model.  That  is, 
such  automatically  defined  Resources  need  not  be  invoked  in  the  Process 
Primitives.  Importantly,  if  an  operative  Resource  is  to  be  identified  with  an 
architectural  element,  it  should  be  defined  first  in  ADE  and  thereafter  edited 
to  provide  it  with  suitable  parameters  (on  the  assumption  that  the  default 
parameters  are  incorrect).  ADE  will  not  allow  the  definition  of  a  node  or 
link  whose  name  is  identical  with  that  of  a  Resource  already  in  existence. 


3UEUES 


Not  all  the  Queues  functioning  in  a  system  model  need  be  defined  by  the  user, 
since  many  are  implicit  in  the  operation  of  the  system.  The  general  rule  is 
that  any  Queue  manipulated  by  the  FILE,  FIND  or  REMOVE  Primitives  must  be 
given  a  separate  definition  in  the  DUI,  with  the  exception  of  a  cross- 
reference  set. 

The  cross-reference  sets  are  explained  in  the  AISIM  User’s  Manual,  section 
3.5.2. 

To  define  a  new  Queue,  type 
E  QUEUE, NAME, NEW 


The  form  for  this  entity  is  shown  in  figure  58. 


QUEUE:  ■■■  SIZE:  mamma 

HIM 

DESCR: 


Figure  58.  Form  for  Queue  Entity 

The  three  fields  should  be  filled  in  with,  respectively,  (a)  the  name  of  the 
Queue  as  found  in  the  FILE,  FIND,  or  REMOVE  Primitive  which  uses  the  Queue, 
(b)  the  maximum  number  of  Items  that  can  be  placed  in  it  (the  default  value 
for  which  is  "infinite")  and  (c)  any  useful  reminder  of  the  Queue's  role  in 
the  modeled  system. 

4.4  CONSTANTS  AND  VARIABLES 

Constants  differ  from  global  Variables  only  in  that  they  do  not  change  their 
values  during  the  simulation  exercise  of  a  model.  Once  a  value  has  been 
assigned  to  a  Constant  and  a  simulation  is  begun,  its  value  is  unchanging. 
Accidental  attempts  to  alter  the  value  of  a  Constant  through  the  EVAL  or 
ASSIGN  Primitives  will  yield  an  execution  error  message.  The  forms  for 
Constants  and  Variables  are  quite  similar  and  are  called  up  by  Issuing  the 
command  EDIT  CONSTANT  or  EDIT  VARIABLE  and  then  giving  the  name  of  the 
Constant  or  Variable. 

The  forms  for  Constants  and  Variables  are  shown  in  figure  59. 
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CONSTANT : 


UALUE :  m 
DESCRIPTION: 


'JAR  I  ABLE: 


•JALUE : 


DESCRIPTION: 


Figure  59.  Forms  for  Constant  And  Variable 


The  fields  CONSTANT  and  VARIABLE  call  for  the  entities'  names.  The  VALUE 
fields  call  for  numerical  values  for  Constants  and  alpha-numerical  values  for 
Variables,  and  the  DESCRIPTION  fields  call  for  any  description. 

4.5  LOADS  AND  SCENARIOS 


The  effect  of  the  environment  on  a  model  is  represented  collectively  by  Loads 
and  Scenarios.  The  relationship  between  Loads  and  Scenarios  is  this:  Loads 
specify  a  number  of  Process  triggerings  to  take  place  sometime  during  the 
simulation  exercise  of  a  model.  Loads  do  not  specify  when  the  Process 
triggerings  are  to  take  place.  They  specify  the  distribution  of  the  time 
passing  between  triggerings  of  the  Process.  Scenarios  specify  a  collection  of 
Loads  and/or  individual  Processes  together  with  a  schedule  indicating  when  the 
specified  Loads  or  Processes  are  to  be  initiated. 

To  define  a  Load,  type 

E  LOAD, NAME, NEW 

The  form  for  the  Load  Entity  is  shown  in  figure  60. 
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The  LOAD  field  holds  the  name  of  the  Load.  The  fields  labeled  N0DE1  through 
N0DE8  indicate  the  architectural  nodes  in  which  the  Processes  named  in  the 
Load  take  place.  The  field  DESCRIPTION  is  for  any  helpful  description. 


The  field  labeled  PROCESS  holds  up  to  five  names  of  Processes.  The  fields 
SCHMTD,  MEAN,  UNITS  and  DELTA  together  define  the  statistical  method  of 
distribution  to  be  used  in  scheduling  the  Process  triggerings.  SCHMTD  holds 
the  name  of  the  distribution  method,  MEAN  holds  the  average  time  between 
Process  initiations  (in  terms  of  the  UNITS  specified)  and  DELTA  is  a  second 
numerical  parameter  used  to  specify  variation  about  the  mean,  if  applicable. 
The  field  MAX  *  indicates  the  maximum  number  of  Process  instances  to  be 
initiated  by  this  Load. 


The  Scenario  entity  defines  the  impact  of  the  environment  on  the  system  for 
the  entire  simulation  exercise  of  a  model.  In  It  the  user  specifies  a  number 
of  "periods"  into  which  a  simulation  exercise  is  to  be  divided,  together  with 
a  uniform  length  each  period  is  to  have.  The  user  then  specifies  a  collection 
of  Loads  or  Processes  to  be  initiated  at  a  specified  time  during  the  simula¬ 
tion.  A  priority  is  also  given  for  each  Process. 


To  define  a  Scenario,  type 


E  SCENARIO, NAME, NEW 

The  form  for  the  Scenario  entity  is  shown  in  figure  61. 
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Figure  61.  Form  for  Scenario  Entity 


The  field  SCENARIO  holds  the  name  of  the  entity.  PERIOD  LENGTH  is  the  length 
of  each  period.  The  field  UNITS  is  the  time  unit  in  which  the  period  length 
is  specified.  The  OUTPUT  UNITS  is  the  time  unit  to  use  when  generating  the 
simulation  output  reports.  The  14  fields  labeled  PERIODS  are  used  to  indicate 
the  number  of  periods  the  Scenario  is  to  have.  The  number  of  periods  in  the 
Scenario  is  determined  by  the  number  of  these  fields  in  which  an  entry  is 
made.  Any  characters  may  be  typed  in  these  fields. 

The  fields  labeled  TRIGGER  take  the  name  of  the  Load  or  Process  to  be 
initiated.  The  field  SCH  TIME  indicates  the  time  at  which  the  Load  or  Process 
named  immediately  to  the  left  Is  to  be  initiated.  The  field  UNITS  is  the  time 
unit  for  scheduling.  The  field  PRIORITY  is  used  to  assign  a  priority  to  the 
named  Process;  it  is  ignored  for  a  Load  and  should  be  left  blank. 


5.  A  WORKING  EXAMPLE 


This  section  documents  the  construction  of  an  A1SIM  model  that  can  be  run 
through  simulation  tests  and  analyzed  in  the  subsequent  chapter.  The  model 
will  be  a  representation  of  the  transmitter /receiver  relationship,  an  element 
of  any  communication  system. 

The  transmitter /receiver  relation  modeled  here  is  of  the  "polling”  or 
"mailbox"  type,  as  opposed  to  the  "interrupt"  type.  In  it,  one  transmitting 
Process  generates  messages  and  delivers  them  to  a  buffer.  There  the  messages 
await  treatment  from  a  receiving  Process.  The  transmitting  and  receiving 
Processes  are  not  in  direct  communication  with  one  another.  Rather,  the 
transmitter  broadcasts  messages  according  to  need,  and  the  receiving  Process 
reads  them  from  the  buffer  at  intervals  in  accordance  with  expected  need.  In 
the  system  envisioned,  transmission  is  randomized  in  two  respects,  (1)  in  the 
lengths  of  transmitted  messages  and  (2)  in  the  intervals  between  transmission. 
Reception  is  undertaken  at  regular  intervals  and  the  time  consumed  in 
processing  a  message  is  a  linear  function  of  its  length. 

The  origination  of  a  message  in  the  transmitting  Process  will  be  represented 
by  the  creation  of  an  Item  (through  the  CREATE  Primitive).  The  Item  will  have 
a  variable  attribute  which  will  represent  its  length.  Since  the  length  will  be 
randomized  over  a  range  of  approximately  700  bytes,  some  mechanism  must  be 
incorporated  for  altering  the  variable  attribute  of  each  data  Item  (i.e., 
message).  This  is  accomplished  by  (1)  generating  a  random  number  in  the  range 
[0,1]  subsequent  to  the  creation  of  each  Item,  (2)  multiplying  the  random 
number  by  twice  the  average  message  length  and  (3)  assigning  the  number  so 
obtained  to  the  message  length.  This  figure  will  then  be  used  to  calculate 
the  time  taken  to  send  the  message  to  the  buffer  (where  it  will  be  available 
to  the  receiving  Process).  Through  an  ACTION  Primitive,  the  clock  is  then 
updated  by  the  amount  calculated. 

In  this  system  the  buffer  will  not  be  manipulated  by  both  the  receiving  and 
the  transmitting  Processes  at  the  same  time,  so  the  buffer  is  considered  a 
Resource  and  its  allocation  and  deallocation  by  the  ALLOC  and  DEALLOC 
Primitives  will  prevent  it  from  being  accessed  simultaneously  by  both 
Processes . 

5.1  DEFINING  PROCESSES 


This  description  of  the  transmitting  Process  gives  the  steps  of  its  execution. 
The  transmitting  Process: 

(1)  Starts 

(2)  Allocates  one  unit  of  a  Resource  BUF1  representing  the  buffer 

(3)  Creates  a  message,  represented  as  an  Item  called  "Msg” 


(4)  Generates  a  random  number  between  0  and  1  and  then  multiplies  it  by 
twice  the  average  message  length 


(5)  Assigns  the  number  obtained  in  the  previous  step  to  the  Item 
attribute  representing  the  message  length 

(6)  Calculates  the  delay  time  which  is  proportional  to  the  message 
length  (i.e.,  an  amount  equal  to  the  message  length  multiplied  by 
the  transmission  rate  in  seconds  per  byte) 

(7)  Delay  for  the  calculated  amount  of  time 

(8)  Delivers  the  message  Item  to  the  Queue  called  Buffer  through  the 
FILE  Primitive 

(9)  Releases  the  Resource  BUF1  representing  the  buffer 
Figure  62  shows  the  Process  flowchart  derived  from  this  description. 


(  END 


The  receiving  Process  will  first  determine  whether  or  not  the  buffer  is  being 
manipulated  by  the  other  Process  by  testing  for  utilization  of  the  Resource 
call  BUF1.  If  the  Resource  is  in  use,  the  Process  will  abort  by  branching  to 
the  END  symbol.  If  BUF1  is  free,  the  Process  will  read  the  next  message  from 
the  buffer,  and  calculate  a  receiving  time  in  roughly  the  same  way  that  the 
transmitting  time  for  that  same  Item  was  determined  in  the  transmitting 
Process.  The  clock  is  then  updated  by  the  amount  of  time  calculated. 

This  description  can  be  expanded  into  more  specific  design  requirements.  The 
receiving  Process 

(1)  Starts. 

(2)  Tests  for  the  availability  of  the  buffer  by  determining  whether  or 
not  the  Resource  is  in  use  through  the  TEST  Primitive.  If  so,  the 
Processes  execution  will  branch  to  the  END  symbol. 

(3)  The  next  message  Item  on  the  Queue  called  Buffer  is  read  via  the 
REMOVE  Primitive. 

(4)  If  there  is  nothing  on  the  buffer,  Process  execution,  as  in  step 
(2),  branches  to  the  END.  This  step  is  represented  by  a  COMPARE 
Primitive . 

(5)  The  message  length  is  assigned  to  a  local  variable  through  the 
ASSIGN  Primitive. 

(6)  A  receiving  time  is  calculated  to  be  proportional  to  the  message 
length  (i.e.,  equal  to  the  message  length  times  some  reception  speed 
in  seconds  per  byte). 

(7)  The  clock  is  updated  through  the  ACTION  Primitive  in  the  amount 
required  to  receive  the  message. 

(8)  The  message  Item,  having  been  read,  is  eliminated  from  the  svstem 
through  the  DESTROY  Primitive. 

(9)  An  ENTRY  Primitive  is  inserted  just  before  the  END  symbol  of  the 
Process  to  indicate  where  execution  is  to  resume  from  the  branching-, 
in  steps  (2)  and  (4). 

Figure  63  shows  the  flowchart  representation  of  the  Process  derived  from  the^- 
requlrements. 


5.2  REMAINING  MODEL  ELEMENTS 


The  reaaining  model  entitles  oust  now  be  defined.  These  Include  si l  the 
entitles  mentioned  in  any  Process  Primitive.  These  are  the  following: 

1)  The  Queue  named  "Buffer"  onto  which  messages  are  filed. 

2)  The  Resource  Bufl  which  represents  a  device  to  protect  the  butter 
against  manipulation  by  two  Processes  at  once. 

3)  The  Item  Msg,  each  instance  of  which  is  to  represent  a  messag** 
transmitted  onto  the  Queue. 

4)  The  global  Variables  named  Gammal,  which  is  twice  the  average  ness 
length,  and  Gamma2,  which  is  the  transmission  rate. 

5.2.1  RESOURCE  DEFINITIONS 

The  Resource  BUF1  is  given  proper  parameters.  It  will  have  onl  one  initia 
unit  and  will  have  a  maximum  of  one.  It  will  retain  the  default  <f  no 
attributes  and  a  cost  of  zero.  An  appropriate  description  is:  "Res-mr  e 
Associated  With  Buffer". 

5.2.2  QUEUE  DEFINITIONS 

The  Queue  called  “Buffer",  which  is  accessed  by  the  FILF.  and  REMOVE  Primi¬ 
tives,  will  retain  its  default  size  of  "Infinite".  A  helpful  descript!  »c  : 
"Buffer  On  Which  Messages  Are  Stored  . 

5.2.3  ITEM  DEFINITION 


The  Item  Msg  which  represents  messages  transmitted  and  receive-!  will 
attribute  called  "Length".  Its  initial  value  will  be  the  literal  "4l.engt- 
since  the  value  of  this  attribute  will  alwavs  be  assigned  within  the  t’t  --es 
that  transmits  it  to  the  buffer. 

5.2.4  VARIABLE  DEFINITION 

The  Variables  "Gammal"  and  "Gamma2"  are  defined  with  i - i ' t a ,  values  f 
and  .002  respect  1  ve  1  y  .  These  va  1  ues  are  used  in  a  1  fu  1  at  :  ng  the  transmit: 
and  reception  time.  Gamma  I  is  twice  the  average  message  length,  and  a-ima 
the  transmit  ion  rate. 

» . 1  LOADS  AND  SCENARIOS 

F  i  n*  1  1  v  ,  we  must  define  t  he  hv  pot  he  *  I  a  I  fond  I  t  1  ins  •  .  *  :  •  t  he  - 

system  will  be  np-ar-l.  Si*  Load*-  are  defined  ‘or  '  *- 1  ■-  -  'e  .  <  ■  • 

ea<  •  'rigger  'he  '  r  ansm  1  t  t  1  ng  Pro*  ess  .  Ml,  ,  a-d  •  ■  .•  t .  *  t  t  gg.-  r  •  •  . 
r  e  -  e  i  ;  og  Pr  Of  ess  :•  a  s-hedule  if  *-  k  pe  <  t  e-1  nee  if  o.  - 

"he  f  r 1 gge  rings  .f  t  -ir  I  rants'.  "  ng  P  r  •>»  e  s  s  ir.  "a  -  ’  e  :  •  t  ,  whe  -  ••  <  - 

'  ’  g  g  e  r  I  ngs  f  the  r  e<  e  l  v  f  ng  Pr  •><  e  s  s  are  s-hedi  >•'  1 1  'eg.  .r  :  -.ru  ». 

•mi  .  e  •  e  I  oad  de  f  1  n  f  t  1  on •  are  „  pages  -  •  r  » i  g  *  *  •  •  e 

.  e  r  ;  f  l  ■  at  !  -ki  Sepr'  wt, ;  ,  r  appears  Append's  H  . 


The  Scenario  for  this  model  consists  of  six  periods.  The  Loads  are 
distributed  throughout  the  simulation  period  as  follows:  each  pair  of  Loads  is 
triggered  at  intervals  of  200  units  on  the  simulation  clock.  The  complete 
definition  is  found  on  page  5  of  the  Model  Verification  Report  in  Appendix  B. 
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6.  SIMULATION  EXERCISES  OF  AISIM  MODELS 


The  model  is  now  ready  to  be  run  through  a  simulation  exercise  to  determine 
its  behavior  under  the  defined  environmental  conditions.  To  begin  this 
exercise,  enter  the  Analysis  User  Interface  (AUI)  from  the  AISIM  READY  level 
by  typing 


A  P(projectname) 


Projectname  is  the  name  of  the  model  we  wish  to  expose  to  a  simulation  exer¬ 
cised  The  user  will  be  prompted  with  information  that  will  look  something 
like  that  shown  in  figure  64. 


CURRENT  PARAMETERS  IN  EFFECT: 

VERSION:  PRODUCTION  VERSION  5.0 

TERMINAL:  HP 

PROJECT:  TEST 

USER:  [USER] 

ENTER  YES  TO  PROCEED,  NO  TO  ABORT... 


Figure  64.  Information  Displayed  on  Entering  The  AUI 


After  declining  the  abort  prompt  by  typing 


AISIM  will  ask  the  user  if  the  current  simulation  run  should  be  commented  with 
the  prompt 


DO  YOU  WANT  TO  ADD  A  DESCRIPTION  FOR  THIS  RUN?(Y/N) 


If  the  user  wishes  to  comment  the  simulation  run,  a  form  will  be  displayed. 
The  form  provides  for  the  entry  of  10  lines  of  information  which  will  be 
placed  at  the  beginning  of  the  output  report. 


Following  the  translation  of  the  model,  the  user  is  in  a  position  to  issue 
commands  before  the  execution  of  the  simulation. 


6.1  INITIALIZING  A  MODEL 


If  more  than  one  Scenario  has  been  defined,  the  system  will  ask 


WHICH  SCENARIO  DO  YOU  WISH  TO  TRANSLATE? 


Type  the  name  of  the  Scenario  that  defines  the  environmental  conditions  t  i 
which  the  model  Is  to  be  subjected.  For  this  model,  we  have  defined  only  one 
Scenario  so  the  program  will  perform  model  initialization.  If  no  errors  nr- 
detected  at  this  stage  the  computer  will  prompt  with 


NO  ERRORS  DETECTED  DURING  MODEL  TRANSLATION 
YOU  MAY  NOW  ENTER  COMMANDS 


If  an  error  had  been  made,  AISIM  would  have  prompted  with 
ERRORS  DETECTED  IN  MODEL  TRANSLATION 


This  prompt  indicates  that  some  aspect  of  the  model  definition  is  in  error. 

If  such  is  the  case,  determine  where  the  errors  are,  see  Appendix  B  of  the 
AISIM  User's  Manual  for  a  description  of  the  error  raessges,  and  return  to  the 
DUI  to  correct  them.  The  matter  of  getting  to  the  DUI  has  already  been 
covered  in  previous  chapters.  For  this  example,  assume  that  the  AISIM  model 
is  properly  defined. 

6.2  DEFINING  PLOTS 

Two  choices  are  available  at  this  point:  Proceed  to  the  simulation  exercise 
of  the  model  jjr_  request  that  graphs  of  some  of  the  activities  monitored  during 
the  simulation  be  defined  so  that  they  can  later  be  inspected  at  the  terminal. 

For  example,  in  the  model  under  consideration,  one  of  our  main  concerns  is  to 
determine  whether  the  buffer  onto  which  the  transmitting  Process  places 
messages  (and  from  which  the  receiving  Process  retrieves  the  messages)  reaches 
some  maximum  burden  or  whether  it  shows  a  tendency  to  infinite  queueing.  To 
produce  a  graph  of  the  behavior  of  the  buffer  we  type 

DEF  QUEUE, BUFFER 

The  screen  will  display  a  selection  of  the  aspects  of  the  behavior  of  a  Queue 
for  which  a  graph  can  be  defined.  These  are  shown  in  figure  65. 


hTTRIBIJTES  ip LmCE  Mrt  X  NEXT  TO  INLY  ONE  I 

INUMBER  IN  QUEUE 

number  blocked 
tine  in  QUEUE 

tine  bl ooed 


Figure  6  S ,  Aspects  of  Queue  Behavior 


To  detine  a  graph  showing  the  number  of  Items  ■  the  Butter,  we  would  * 
"X"  for  "NUMBER  IN  QUEUE".  The  screen  would  t  ben  dlsplav  t  tie  ■ t  :  us  •  > 

defining  the  type  statistic  on  the  number  ot  Items  in  the  . Thes« 

options  are  shown  in  figure  6n . 
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STATISTICS  (PLACE  AN  X  NEXT  TO  ONLY  ONE) 


CURRENT 

CUMULATIVE  MEAN 
CUM  STANDARD  DEV 
CUMULATIVE  MIN 
CUMULATIVE  MAX 
PERIOD  MEAN 
PEP  SThNDAPD  OEU 
PERIOD  MIN 
PERIOD  MAX 


Figure  66.  Options  for  Statistics 

To  calculate  the  current  nuaber  of  message  Items  in  the  Queue  called  "Buffer" 
at  any  given  time,  enter  an  ”X“  next  to  "CURRENT".  The  entities  with  respect 
to  which  graphs  can  be  defined  are  Resources,  Queues,  Processes,  Items  and 
Variables.  Up  to  ten  such  graphs  may  be  defined  per  analysis  session. 

6.3  STARTING  THE  SIMULATION 

Once  the  aodel  is  initialized  and  graphs  are  defined,  the  model  may  be  exe¬ 
cuted  through  a  simulation  run.  The  execution  of  the  model  may  be  triggered 
either  for  the  entire  Scenario  or  for  a  specified  number  of  periods,  so  that 
global  Variables  can  be  given  new  values  different  from  those  previously 
defined  in  the  DU I. 

The  values  of  Constants  and  the  initial  values  of  global  Variables  may  ilso  he 
changed  before  a  simulation  exercise  begins.  The  former  option  will  he  chosen 
in  this  example  to  investigate  the  effect  of  altering  the  time  required  to 
transmit  or  to  process  message  Items.  To  begin  the  simulation,  tvpe 

GO  l 

This  command  Indicates  that  the  simulation  is  to  be  run  for  1  of  the  simuli- 
tlon  periods  defined  when  the  model  was  created  In  the  MCI.  When  the 
simulation  starts,  a  message  will  he  displayed  which  provides  the  re.il  time  r 

which  the  simulation  began.  Aa  the  first  simulation  period  completes,  i 

subsequent  message  will  be  displayed  showing  the  peri  >d  number  cxspletei  >u» 
of  the  total  number  of  periods,  the  simulation  time,  »nl  r  fie  real  time  w*'e  ■ 
the  |»erl'>d  ended.  Then  the  screen  will  ijffer  the  foil  >w :  ■  v  message 

KNM  if  PKKl'fD 
YUC  M>y  viW  '■<  MMANMS 

*>  .  s  f.UiriNt,  VAHlABLfs  BhlWf-KN  ■  1  ’  A  f  I<»N  sTAl.t  d- 

To  t  ange  t  he  a  1  ie  •  f  t  /ar  table,  !  >  s  ie  *  ».,•  .« p|>  t  1  I  i  ’  ■ 

Inf  -r  m  at  1  >n  it  1  I  •  >,*■  <  v  pe  .(  .•  >  !  t  >  .  e  1  ■  ’  ••  1 


■‘T  1 


entity  whose  value  is  to  be  changed  and  (c)  the  new  numerical  value  of  the 
entity.  The  Variable  Gamma2  formerly  had  the  value  of  .002.  To  change  it  to 
.001,  type 

E  V,gamoa2, .001 

The  simulation  may  be  continued  for  two  more  periods  by  typing 
GO  2 

When  this  stage  of  the  simulation  is  completed,  the  value  of  Variables  may  be 
changed  back  to  .002  by  typing 

E  V .gamma 2 , .002 

To  command  that  the  remainder  of  the  Scenario  be  run  through  without  further 
interruption,  type  the  GO  command  without  a  numeric  parameter,  thus: 

GO 

If  no  mistakes  were  made  in  constructing  the  model  that  cause  the  simulation 
to  abort,  the  computer  will  prompt,  after  some  time,  that  the  simulation  is 
completed . 

The  plot  produced  by  this  run  is  shown  in  figure  67,  and  the  output  report 
appears  in  Appendix  B. 
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7.  A  MORE  ELABORATE  EXAMPLE 

In  this  section  a  communication  system  slightly  more  complicated  than  that 
designed  in  Section  5  and  analyzed  in  Section  6  is  constructed.  To  do  this, 
however,  requires  that  we  introduce  one  further  AISIM  feature. 

7.1  MESSAGE  ROUTING  SUBMODEL 

When  one  Process  is  triggered  by  another  through  a  CALL  primitive,  the  called 
Process  will  execute  in  the  same  architectural  node  as  the  one  that  triggered 
it,  i.e.,  utilize  the  same  Resource,  even  if  the  two  Processes  are  normally 
associated  with  different  nodes.  This  is  inconvenient  in  the  representation 
of  communication  systems  in  which  an  activity  in  one  hardware  element  causes 
activity  in  another  one.  AISIM  therefore  embodies  a  submodel  to  represent  the 
situation  in  which  a  Process  in  one  node  triggers  a  Process  in  another  node  by 
communicating  through  the  network  architecture.  This  submodel  consists  of  a 
collection  of  Processes  and  one  Item. 

The  Processes  that  accomplish  this  must  be  placed  in  a  project  database  with 
the  commands  available  in  the  Library  User  Interface.  The  entities  of  this 
submodel  need  not  be  defined  anew.  For  information  on  the  use  of  this 
facility,  see  the  AISIM  User's  Manual,  Section  10. 

7.2  DEFINING  ARCHITECTURAL  ELEMENTS 

Consider  modeling  a  communication  system  between  two  airbases,  a  headquarters 
and  a  command  headquarters  that  communicates  directly  with  a  computer  disk. 
Between  these  end-points  are  switches  that  govern  the  routing  of  messages 
through  the  system.  The  physical  layout  of  this  system  is  shown  in  figure  68. 
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Figure  68.  System  Architecture 

For  this  example,  the  shortest  paths  between  the  nodes  will  be  used.  There¬ 
fore,  subsequent  to  defining  the  architecture,  method  B  is  used  to  create  the 
Legal  Path  Table.  The  resulting  table  is  depicted  in  the  analysis  report 
given  in  Appendix  C. 

The  operations  associated  with  this  architecture  are  as  follows.  Both  air¬ 
bases  periodically  broadcast  messages  to  the  other  nodes  in  the  system  and 
request  plans  from  the  command  headquarters. 

The  effect  of  each  broadcast  is  to  (1)  stimulate  processing  in  the  HQ  and  CHQ 
and  to  cause  the  updating  of  information  in  all  other  nodes.  Periodically  an 
applications  program  in  L3  requests  plans  from  the  CHQ,  as  do  AB1  and  AB2. 

The  effect  of  any  such  request  is  to  engage  the  operation  of  the  disk  that 
communicates  directly  (and  only)  with  the  CHQ. 

This  description  of  the  main  operations  of  the  system  implies  the  following 
more  rigorous  listing  of  the  Processes  that  need  to  be  defined  to  represent 
such  a  system.  The  Processes  required  will  be: 

— A  Process  to  represent  the  request  from  the  HQ  to  the  CHQ  for  plans. 

It  will  execute  in  the  HQ  node  and  will  trigger  a  Process  in  the  CHQ 
node . 
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— A  Process  to  represent  the  broadcast  of  data  from  AB1  and  AB2  to  all 
other  nodes.  This  Process  will  execute  in  the  nodes  AB1  and  AB2  and 
will  trigger  an  updating  Process  in  (a)  the  HQ  node,  (b)  the  CHQ  node 
and  (c)  each  other,  i.e.,  a  broadcast  in  one  airbase  will  update 
information  in  the  other. 

— A  Process  to  represent  the  updating  activity  that  occurs  in  the  CHQ, 
triggered  by  broadcasts  from  the  airbases. 

—A  Process  to  represent  the  updating  activity  that  occurs  in  the  HQ  that 
is  triggered  by  broadcasts  from  the  airbases. 

— A  Process  to  represent  the  updating  activity  in  the  airbases  which  is 
triggered  by  broadcasts  from  one  another. 

— A  Process  to  represent  the  formulation  of  plans  at  the  CHQ,  which  is 
triggered  by  requests  from  ABl,  AB2  and  HQ.  This  Process  executes  in 
the  CHQ  node  and  triggers  another  Process  representing  disk  operation 
in  the  disk  node. 

—A  Process  to  represent  the  operation  of  the  disk  that  communicates  with 
the  CHQ  node. 

These  descriptions  can  be  used  to  generate  the  AISIM  Process  definitions  found 
on  the  following  pages.  The  Process  flowcharts  for  each  are  displayed, 
together  with  annotations  to  clarify  the  rationale  for  the  steps  that  might 
otherwise  be  obscure. 
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Figure  69.  Defined  Resource  Entities 


Since  these  Resources  are  created  with  default  values  (an  initial  unit  of  1 ,  a 
maximum  unit  of  1,  and  a  default  description),  they  must  be  edited  to  provide 
helpful  descriptions  and  to  give  them  attributes  since  attributes  of  these 


Resources  are  accessed  in  several  places  in  the  Message  Routing  Submodel. 
Descriptions  and  attributes  can  be  edited  before  generating  the  architecture 
using  the  ADE’s  DEFINE  command.  See  Section  2.2  of  this  manual. 
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7.1.2  FILL  INC  IN  THE  ACTION  DEFINITIONS 


The  Action  Primitive*  In  th«  Pr^cesse*  nuit  have  corresponding  Action  entit' 
definitions  outside  the  Process  «#ht>-h  sre  sot  omat  1  cs  1 1  v  crested  bv  A  l  S  l  M .  The 

Actions  used  sre  these- 

•s.  • :  an  oeiceietion 

rce**o  w  T* T1SB  >0  n. -vm  f eoe  hq 

c*T«'  -  cSTBc^  nwsi  AjtSiguD'T  ro  j cck 
•0»,’£ _»  •tottuin  0CLRv  *0  SQUT|  a  etSMl 
>€£•  itl»  ino  I /*m •  ■  >>  y  m« 

^berifsi  i^eo  si'et  eet.ious  seoto  *?  -*xts 

fe»  ’»>»ivn  i.*eae*s»' :  an  mx/ont  an  oi» 

-rt*  OH  e^OCSSSItQ  oor  '0  son  a  NESS**  >t*  e  Mure® 

Figure  TO.  Defined  Action  Entitles 


7.3.3  CONSTANTS  AND  GLOBAL  VARIABLES 

This  model  contains  five  global  Variables  (ABDRATE,  ABRATE,  HQRATE ,  TIME1  and 
VRATE)  and  one  Constant  (V_TRAC£).  Their  defined  values  and  descriptions 
(which  explain  their  role  In  the  model)  are  as  shown  In  figure  71. 


MfCftftTE  INTERVAL  PATE  KThtfCM  SIGNALS 

MBPS  ATE  INTERVAL  RATE  BETWEEN  SIGNALS 

HQRPATE  INTERVAL  BETWEEN  SIGNALS 

TtnEl  AVERAGE  SEEK  USE  FOR  DISK  IN  HILLtSECOKlS 

orate  SU  1TCH-0TV«r  node  CHATS®.  SPEED  In  NS- BYTE 

v_ trace  default  is  NO  trace  on 


Figure  71.  Defined  Constant  and  Variable  Entitles 


7.3.4  DEFINING  LOADS  AND  SCENARIOS 

In  this  model  we  wl9h  to  represent  the  seversl  Process  triggerings  that  are 
due  to  causes  outside  the  system.  First,  the  ABl  and  AB2  *111  broadcast 
cooimunl cat  ions  to  the  other  nodes  (which  trigger  updating  Processes  in  them) 
every  minute,  by  an  interval  scheduling  method.  In  addition,  ABl  and  AB2  will 
issue  requests  for  plans  from  the  CHQ  sixty  times  in  one  hour  by  an  exponen¬ 
tial  scheduling  method.  We  define  a  second  Load  to  represent  requests  from  the 
leaf-node,  L3,  also  for  plans  from  r.he  CHQ.  This  Process  will  also  be  under¬ 
taken  sixty  times  per  hour,  exponentially  distributed.  The  Load  definitions 
implied  by  these  requirements  are  printed  in  appendix  C. 

The  length  of  the  entire  Scenario  is  360,000  milliseconds  (one  hour),  which  is 
divided  into  ten  periods  of  six  minutes  each.  To  simulate  the  operation  of 
the  system  with  the  worst  case,  we  stipulate  that  both  of  the  functional  Loads 
are  triggered  simultaneously,  at  the  beginning  of  the  Scenario.  In  addition, 
as  a  monitoring  device,  we  initiate  the  Trace  Process  at  the  beginning  of  the 
simulation  run.  The  parameters  for  the  Scenario  implied  by  these  requirements 
are  printed  page  16  of  the  analysis  report  in  appendix  C. 
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7  .4 


To  run  the  model  through  a  simulation  test.  Invoice  the  Analysis  '■••r  lot 
tram  the  AISIM  READY  level.  For  this  example,  the  simulation  will  not  k 
Interrupted  at  the  _*nds  of  periods,  nor  wl  1 !  graphs  be  defined. 

The  analysis  report  obtained  from  a  simulation  run  cf  this  model  appears 

appendix  C. 
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Figure  72. 

Terminal  Prof ; 

les  for 

Forms 

Figure  72  describes  the  function  keys  which  are  used  to  move  through  the  fun- 
on  each  terminal.  Following  is  a  description  of  the  ways  In  which  a  user  can 
move  through  a  form.  These  movements  correspond  to  the  column  headings  In  the 
figure. 

UP  -  If  the  cursor  Is  In  a  block  of  fields,  such  as  Resource  attributes,  the 
cursor  will  move  up  to  the  field  above  it.  If  the  cursor  Is  in  a  single  field 
or  at  the  top  of  a  block,  the  cursor  will  move  to  the  end  of  the  next  field 
above  it.  If  there  are  no  fields  above  it,  the  cursor  will  wrap  to  the  end  ut 
the  last  field  In  the  form. 

DOWN  -  If  the  cursor  Is  in  a  block  of  fields,  such  as  Resource  attributes,  the 

cursor  will  move  down  to  the  field  below  it.  If  the  cursor  Is  In  a  single 

field  or  at  the  bottom  of  a  block,  the  cursor  will  move  to  the  beginning  of 

the  next  field  below  it.  If  there  are  no  fields  below  it,  the  cursor  will 

wrap  to  the  beginning  of  the  first  field  in  the  form. 

LEFT  -  The  cursor  will  move  one  position  to  the  left  in  the  current  field.  If 
the  cursor  is  at  the  beginning  of  a  field,  it  will  move  to  the  end  of  the 
previous  field.  If  the  cursor  is  at  the  top  of  the  form.  It  will  wrap  to  the 
end  of  the  last  field  in  the  form. 

RIGHT  -  The  cursor  will  move  one  position  to  the  right  in  the  current  field. 

If  the  cursor  is  at  the  end  of  a  field,  it  will  move  to  the  beginning  of  the 
next  field.  If  the  cursor  is  at  the  end  of  the  form,  it  will  wrap  to  the 
beginning  of  the  first  field  in  the  form. 

ENTER  -  Exit  the  form  and  send  the  data  in  the  form  to  be  processed  by  the 
AISIM  system. 
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APPENDIX  B 


SIMULATION  REPORT  FOR  WORKING  EXAMPLE 


AD-A188  998  AUTOMATED  INTERACTIVE  SIMULATION  MODEL  (AISIH)  VAX 
VERSION  38  TRAINING  HA.  .  (U)  HUGHES  AIRCRAFT  CO 
FULLERTON  CA  GROUND  SVSTEMS  GROUP  V  ALLERTON  ET  AL. 
UNCLASSIFIED  29  HAY  87  HAC-183489S-2  ESD-TR-87-232  F/O  12/3 
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